Add Apache HTTP Message XML docs

docs/xml/Org.Apache.Http.Message/AbstractHttpMessage.xml

@@ -223,7 +223,7 @@
       <Docs>
         <param name="name">the header name to check for.</param>
         <summary>Checks if a certain header is present in this message.</summary>
-        <returns>To be added.</returns>
+        <returns>true when at least one header has the specified 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>
@@ -260,7 +260,7 @@
       <Parameters />
       <Docs>
         <summary>Returns all the headers of this message.</summary>
-        <returns>To be added.</returns>
+        <returns>All message headers, in the order in which they are sent over a connection.</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>
@@ -294,7 +294,7 @@
       <Docs>
         <param name="name">the name of the header to return.</param>
         <summary>Returns the first header with a specified name of this message.</summary>
-        <returns>To be added.</returns>
+        <returns>The first header with the specified name, or null when none exists.</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>
@@ -334,7 +334,7 @@
       <Docs>
         <param name="name">the name of the headers to return.</param>
         <summary>Returns all the headers with a specified name of this message.</summary>
-        <returns>To be added.</returns>
+        <returns>All headers with the specified name, in the order in which they are sent over a connection.</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>
@@ -368,7 +368,7 @@
       <Docs>
         <param name="name">the name of the header to return.</param>
         <summary>Returns the last header with a specified name of this message.</summary>
-        <returns>To be added.</returns>
+        <returns>The last header with the specified name, or null when none exists.</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>
@@ -427,7 +427,7 @@
       <Parameters />
       <Docs>
         <summary tool="true">Returns an iterator of the headers with a given name.</summary>
-        <returns>To be added.</returns>
+        <returns>An iterator that returns matching headers in the order in which they are sent over a connection.</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>
@@ -462,7 +462,7 @@
         <param name="name">the name of the headers over which to iterate, or
                   <c>null</c> for all headers</param>
         <summary>Returns an iterator of the headers with a given name.</summary>
-        <returns>To be added.</returns>
+        <returns>An iterator that returns matching headers in the order in which they are sent over a connection.</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>
@@ -535,7 +535,7 @@
       <Docs>
         <summary>Returns the parameters effective for this message as set by
  <see cref="P:Org.Apache.Http.IHttpMessage.Params" />.</summary>
-        <value>To be added.</value>
+        <value>The parameters effective for this message.</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>
@@ -564,8 +564,8 @@
         <ReturnType>Org.Apache.Http.ProtocolVersion</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the protocol version with which this message is compatible.</summary>
+        <value>The compatible protocol version.</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.Message/BasicHeader.xml

@@ -98,8 +98,8 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <param name="value">To be added.</param>
+        <param name="name">The header name.</param>
+        <param name="value">The header value.</param>
         <summary>Constructor with name and value</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>
@@ -168,7 +168,7 @@
       <Parameters />
       <Docs>
         <summary>Returns an array of <see cref="T:Org.Apache.Http.IHeaderElement" />s constructed from my value.</summary>
-        <returns>To be added.</returns>
+        <returns>An array of header elements constructed from this header value.</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>
@@ -240,7 +240,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the header name.</summary>
-        <value>To be added.</value>
+        <value>The header name.</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>
@@ -337,7 +337,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the header value.</summary>
-        <value>To be added.</value>
+        <value>The current header value.</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.Message/BasicHeaderElement.xml

@@ -98,8 +98,8 @@
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <param name="value">To be added.</param>
+        <param name="name">The header element name.</param>
+        <param name="value">The header element value, which can be null.</param>
         <summary>Constructor with name and value.</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>
@@ -136,9 +136,9 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="name">To be added.</param>
-        <param name="value">To be added.</param>
-        <param name="parameters">To be added.</param>
+        <param name="name">The header element name.</param>
+        <param name="value">The header element value, which can be null.</param>
+        <param name="parameters">The header element parameters, which can be null. The array is retained by reference.</param>
         <summary>Constructor with name, value and parameters.</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>
@@ -204,7 +204,7 @@
       <Docs>
         <param name="index">the index of the parameter, 0-based</param>
         <summary>Obtains the parameter with the given index.</summary>
-        <returns>To be added.</returns>
+        <returns>The parameter at the specified zero-based index.</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>
@@ -239,7 +239,7 @@
       <Docs>
         <param name="name">The name to search by.</param>
         <summary>Returns parameter with the given name, if found.</summary>
-        <returns>To be added.</returns>
+        <returns>The parameter with the specified name, or null when none is found.</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>
@@ -277,7 +277,7 @@
       <Parameters />
       <Docs>
         <summary>Get parameters, if any.</summary>
-        <returns>To be added.</returns>
+        <returns>An array of parameters. A new array is returned for each call and may be modified without affecting this header element.</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>
@@ -346,7 +346,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the name.</summary>
-        <value>To be added.</value>
+        <value>The header element name.</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>
@@ -377,7 +377,7 @@
       </ReturnValue>
       <Docs>
         <summary>Obtains the number of parameters.</summary>
-        <value>To be added.</value>
+        <value>The number of parameters.</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>
@@ -474,7 +474,7 @@
       </ReturnValue>
       <Docs>
         <summary>Returns the value.</summary>
-        <value>To be added.</value>
+        <value>The current header element value.</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.Message/BasicHeaderElementIterator.xml

@@ -162,7 +162,7 @@
       <Docs>
         <summary>Indicates whether there is another header element in this 
  iteration.</summary>
-        <value>To be added.</value>
+        <value>true when another header element is available in this iteration.</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>
@@ -261,7 +261,7 @@
       <Parameters />
       <Docs>
         <summary>Obtains the next header element from this iteration.</summary>
-        <returns>To be added.</returns>
+        <returns>The next header element in this iteration.</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>