Document Apache HTTP connection schemes

docs/xml/Org.Apache.Http.Conn.Schemes/PlainSocketFactory.xml

@@ -148,7 +148,7 @@
                   0 or a negative number for any</param>
         <param name="params">additional <see cref="T:Org.Apache.Http.Params.IHttpParams" /> for connecting</param>
         <summary>Connects a socket to the given host.</summary>
-        <returns>To be added.</returns>
+        <returns>the connected socket</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -181,7 +181,7 @@
       <Parameters />
       <Docs>
         <summary>Creates a new, unconnected socket.</summary>
-        <returns>To be added.</returns>
+        <returns>a new socket</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -216,7 +216,7 @@
       <Docs>
         <param name="sock">the connected socket</param>
         <summary>Checks whether a socket connection is secure.</summary>
-        <returns>To be added.</returns>
+        <returns><c>false</c></returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -284,7 +284,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets the singleton instance of this class.</summary>
-        <value>To be added.</value>
+        <value>the one and only plain socket factory</value>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>

docs/xml/Org.Apache.Http.Conn.Schemes/Scheme.xml

@@ -60,9 +60,9 @@
         <Parameter Name="port" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <param name="factory">To be added.</param>
-        <param name="port">To be added.</param>
+        <param name="name">the scheme name, for example <c>http</c>. The name will be converted to lowercase.</param>
+        <param name="factory">the factory for creating sockets for communication with this scheme</param>
+        <param name="port">the default port for this scheme</param>
         <summary>Creates a new scheme.</summary>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
@@ -91,7 +91,7 @@
       </ReturnValue>
       <Docs>
         <summary>Obtains the default port.</summary>
-        <value>To be added.</value>
+        <value>the default port for this scheme</value>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -123,7 +123,7 @@
       <Docs>
         <param name="obj">the object to compare with</param>
         <summary>Compares this scheme to an object.</summary>
-        <returns>To be added.</returns>
+        <returns><c>true</c> if the argument is equal to this scheme; otherwise, <c>false</c></returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -151,7 +151,7 @@
       </ReturnValue>
       <Docs>
         <summary>Indicates whether this scheme allows for layered connections.</summary>
-        <value>To be added.</value>
+        <value><c>true</c> if layered connections are possible; otherwise, <c>false</c></value>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -214,7 +214,7 @@
       </ReturnValue>
       <Docs>
         <summary>Obtains the scheme name.</summary>
-        <value>To be added.</value>
+        <value>the name of this scheme, in lowercase</value>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -247,7 +247,7 @@
         <param name="port">the port to be resolved,
                   a negative number to obtain the default port</param>
         <summary>Resolves the correct port for this scheme.</summary>
-        <returns>To be added.</returns>
+        <returns>the given port or the default port</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -275,7 +275,7 @@
       </ReturnValue>
       <Docs>
         <summary>Obtains the socket factory.</summary>
-        <value>To be added.</value>
+        <value>the socket factory for this scheme</value>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -370,7 +370,7 @@
       <Parameters />
       <Docs>
         <summary>Return a string representation of this object.</summary>
-        <returns>To be added.</returns>
+        <returns>a human-readable string description of this scheme</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>

docs/xml/Org.Apache.Http.Conn.Schemes/SchemeRegistry.xml

@@ -87,7 +87,7 @@
       <Docs>
         <param name="name">the name of the scheme to look up (in lowercase)</param>
         <summary>Obtains a scheme by name, if registered.</summary>
-        <returns>To be added.</returns>
+        <returns>the scheme, or <c>null</c> if there is none by this name</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -119,7 +119,7 @@
       <Docs>
         <param name="host">the host for which to obtain the scheme</param>
         <summary tool="true">Obtains a scheme by name.</summary>
-        <returns>To be added.</returns>
+        <returns>the scheme for the given host, never <c>null</c></returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -153,7 +153,7 @@
       <Docs>
         <param name="name">the name of the scheme to look up (in lowercase)</param>
         <summary>Obtains a scheme by name.</summary>
-        <returns>To be added.</returns>
+        <returns>the scheme, never <c>null</c></returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -218,7 +218,7 @@
       <Docs>
         <param name="sch">the scheme to register</param>
         <summary>Registers a scheme.</summary>
-        <returns>To be added.</returns>
+        <returns>the scheme previously registered with that name, or <c>null</c> if none was registered</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -250,7 +250,7 @@
       </ReturnValue>
       <Docs>
         <summary>Obtains the names of the registered schemes in their default order.</summary>
-        <value>To be added.</value>
+        <value>a list containing registered scheme names</value>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -287,8 +287,8 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="map">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="map">protocol schemes</param>
+        <summary>Populates the internal collection of registered protocol schemes with the content of the supplied map.</summary>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>
@@ -381,7 +381,7 @@
       <Docs>
         <param name="name">the name of the scheme to unregister (in lowercase)</param>
         <summary>Unregisters a scheme.</summary>
-        <returns>To be added.</returns>
+        <returns>the unregistered scheme, or <c>null</c> if there was none</returns>
         <remarks>
           <para>Portions of this page are modifications based on work created and shared by the <format type="text/html"><a href="https://developers.google.com/terms/site-policies" title="Android Open Source Project">Android Open Source Project</a></format> and used according to terms described in the <format type="text/html"><a href="https://creativecommons.org/licenses/by/2.5/" title="Creative Commons 2.5 Attribution License">Creative Commons 2.5 Attribution License.</a></format></para>
         </remarks>