[docs] documentation import for 'returns' elements.

18 files changed, 104 insertions, 26 deletions

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>