From d4ec8425a4c48b4a90720fc2b18f070f48921a22 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 01:27:01 -0500 Subject: [PATCH 1/2] Document Apache HTTP connection parameters Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../ConnConnectionParamBean.xml | 8 +++--- .../ConnManagerParamBean.xml | 12 ++++----- .../ConnManagerParams+InterfaceConsts.xml | 8 +++--- .../ConnManagerParams.xml | 14 +++++----- .../ConnPerRouteBean.xml | 22 +++++++-------- .../ConnRouteParamBean.xml | 12 ++++----- .../ConnRouteParams+InterfaceConsts.xml | 8 +++--- .../ConnRouteParams.xml | 14 +++++----- .../IConnConnectionPNames.xml | 13 ++++++--- .../IConnManagerPNames.xml | 27 +++++++++++++------ .../IConnPerRoute.xml | 4 +-- .../IConnRoutePNames.xml | 27 +++++++++++++------ 12 files changed, 98 insertions(+), 71 deletions(-) diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml index 6f6a30633..3a1991c3e 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml @@ -59,7 +59,7 @@ - To be added. + The HTTP parameters to configure. @@ -115,8 +115,8 @@ Java.Interop.JniPeerMembers - To be added. - To be added. + Gets the JNI peer member metadata for this type. + The JNI peer member metadata for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -145,7 +145,7 @@ - To be added. + The maximum number of ignorable lines before an HTTP response status line. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml index 98b3b669f..835962221 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml @@ -59,7 +59,7 @@ - To be added. + The HTTP parameters to configure. @@ -115,8 +115,8 @@ Java.Interop.JniPeerMembers - To be added. - To be added. + Gets the JNI peer member metadata for this type. + The JNI peer member metadata for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -145,7 +145,7 @@ - To be added. + The lookup object for the maximum number of connections allowed per route. @@ -178,7 +178,7 @@ - To be added. + The maximum number of connections allowed. @@ -211,7 +211,7 @@ - To be added. + The timeout, in milliseconds, for retrieving a connection from the connection manager. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams+InterfaceConsts.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams+InterfaceConsts.xml index f21556ec5..22ca86fce 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams+InterfaceConsts.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams+InterfaceConsts.xml @@ -18,7 +18,7 @@ - To be added. + Constants inherited from . Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -44,7 +44,7 @@ System.String - To be added. + Defines the maximum number of connections per route. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -70,7 +70,7 @@ System.String - To be added. + Defines the maximum number of connections in total. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -96,7 +96,7 @@ System.String - To be added. + Defines the timeout, in milliseconds, used when retrieving a managed client connection from the connection manager. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml index 1de7493d9..a41ce4146 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml @@ -118,7 +118,7 @@ HTTP parameters Returns lookup interface for maximum number of connections allowed per route. - To be added. + The lookup interface for the maximum number of connections allowed per route. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -151,7 +151,7 @@ HTTP parameters Gets the maximum number of connections allowed. - To be added. + The maximum number of connections allowed. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -182,11 +182,11 @@ - To be added. + The HTTP parameters. Returns the timeout in milliseconds used when retrieving a from the . - To be added. + The timeout in milliseconds. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -217,8 +217,8 @@ Java.Interop.JniPeerMembers - To be added. - To be added. + Gets the JNI peer member metadata for this type. + The JNI peer member metadata for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -317,7 +317,7 @@ - To be added. + The HTTP parameters. the timeout in milliseconds Sets the timeout in milliseconds used when retrieving a diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml index 9bf8824ef..e1313de68 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml @@ -93,7 +93,7 @@ - To be added. + The default maximum number of connections allowed per route. @@ -124,7 +124,7 @@ - To be added. + The default maximum number of connections allowed per route. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -185,10 +185,10 @@ - To be added. + The HTTP route for which to retrieve the maximum connection count. - To be added. + The maximum number of connections for the route, or the default maximum when no route-specific value is set. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -226,8 +226,8 @@ Java.Interop.JniPeerMembers - To be added. - To be added. + Gets the JNI peer member metadata for this type. + The JNI peer member metadata for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -256,7 +256,7 @@ - To be added. + The default maximum number of connections allowed per route. Must be greater than zero. @@ -289,8 +289,8 @@ - To be added. - To be added. + The HTTP route for which to set the maximum connection count. + The maximum number of connections allowed for the route. Must be greater than zero. @@ -329,8 +329,8 @@ - To be added. - To be added. + The map of HTTP routes to their maximum connection counts, or to leave the current values unchanged. + Replaces the route-specific maximum connection counts. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml index 5e0f38c75..aa9451282 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml @@ -59,7 +59,7 @@ - To be added. + The HTTP parameters to configure. @@ -115,8 +115,8 @@ Java.Interop.JniPeerMembers - To be added. - To be added. + Gets the JNI peer member metadata for this type. + The JNI peer member metadata for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -145,7 +145,7 @@ - To be added. + The default proxy value to set. @@ -178,7 +178,7 @@ - To be added. + The forced route value to set. @@ -211,7 +211,7 @@ - To be added. + The local address value to set. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams+InterfaceConsts.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams+InterfaceConsts.xml index 293d62a28..f60b13221 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams+InterfaceConsts.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams+InterfaceConsts.xml @@ -18,7 +18,7 @@ - To be added. + Constants inherited from . Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -44,7 +44,7 @@ System.String - To be added. + Defines the parameter for the default proxy. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -70,7 +70,7 @@ System.String - To be added. + Defines the parameter for a forced route. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -96,7 +96,7 @@ System.String - To be added. + Defines the parameter for the local address. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml index 167cdecc3..d0e72757e 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml @@ -87,7 +87,7 @@ the parameters in which to look up Obtains the parameter value. - To be added. + The default proxy set in the parameters, or if none is set. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -120,7 +120,7 @@ the parameters in which to look up Obtains the parameter value. - To be added. + The forced route set in the parameters, or if none is set. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -153,7 +153,7 @@ the parameters in which to look up Obtains the parameter value. - To be added. + The local address set in the parameters, or if none is set. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -188,8 +188,8 @@ Java.Interop.JniPeerMembers - To be added. - To be added. + Gets the JNI peer member metadata for this type. + The JNI peer member metadata for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -216,7 +216,7 @@ A special value indicating "no host". - To be added. + A valid host value used to indicate no host. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. @@ -244,7 +244,7 @@ A special value indicating "no route". - To be added. + A route with as its target, used to indicate no route. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/IConnConnectionPNames.xml b/docs/xml/Org.Apache.Http.Conn.Params/IConnConnectionPNames.xml index a44d6f5aa..3f2395c30 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/IConnConnectionPNames.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/IConnConnectionPNames.xml @@ -15,8 +15,10 @@ - To be added. - To be added. + Parameter names for connections in HttpConn. + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + @@ -39,8 +41,11 @@ System.String - To be added. - To be added. + Defines the maximum number of ignorable lines before an HTTP response status line is expected. + + With persistent HTTP/1.1 connections, surplus bytes from an incorrect content length can be detected only before the next response. This parameter expects an integer value. Zero disallows all ignorable lines, and permits an unlimited number. + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + diff --git a/docs/xml/Org.Apache.Http.Conn.Params/IConnManagerPNames.xml b/docs/xml/Org.Apache.Http.Conn.Params/IConnManagerPNames.xml index f3e356344..90d1c7f55 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/IConnManagerPNames.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/IConnManagerPNames.xml @@ -15,8 +15,10 @@ - To be added. - To be added. + Parameter names for connection managers in HttpConn. + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + @@ -39,8 +41,11 @@ System.String - To be added. - To be added. + Defines the maximum number of connections per route. + + This limit applies to individual client connection manager instances and expects an value. + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + @@ -63,8 +68,11 @@ System.String - To be added. - To be added. + Defines the maximum number of connections in total. + + This limit applies to individual client connection manager instances and expects an integer value. + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + @@ -87,8 +95,11 @@ System.String - To be added. - To be added. + Defines the timeout, in milliseconds, used when retrieving a managed client connection from the connection manager. + + This parameter expects a long integer value. + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + diff --git a/docs/xml/Org.Apache.Http.Conn.Params/IConnPerRoute.xml b/docs/xml/Org.Apache.Http.Conn.Params/IConnPerRoute.xml index 1ee928193..cce24613e 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/IConnPerRoute.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/IConnPerRoute.xml @@ -65,10 +65,10 @@ - To be added. + The HTTP route for which to retrieve the maximum connection count. - To be added. + The maximum number of connections allowed for the route. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/IConnRoutePNames.xml b/docs/xml/Org.Apache.Http.Conn.Params/IConnRoutePNames.xml index 3aa6845c5..78f720165 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/IConnRoutePNames.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/IConnRoutePNames.xml @@ -15,8 +15,10 @@ - To be added. - To be added. + Parameter names for routing in HttpConn. + + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + @@ -39,8 +41,11 @@ System.String - To be added. - To be added. + Defines the parameter for the default proxy. + + The default value is used by some route planner implementations, including the default implementation. This parameter expects an value. + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + @@ -63,8 +68,11 @@ System.String - To be added. - To be added. + Defines the parameter for a forced route. + + Standard route planner implementations return the forced route instead of computing one, even when it points to an incorrect target host. This parameter expects an value. + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + @@ -87,8 +95,11 @@ System.String - To be added. - To be added. + Defines the parameter for the local address. + + On a device with multiple network interfaces, this parameter selects the interface from which the connection originates. This parameter expects a value. + Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. + From 4da2b6d02b7c704ce4f520932d774862c244466f Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Sat, 15 Aug 2026 01:37:56 -0500 Subject: [PATCH 2/2] Align JNI member documentation Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml | 4 ++-- docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml | 4 ++-- docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml | 4 ++-- docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml | 4 ++-- docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml | 4 ++-- docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml | 4 ++-- 6 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml index 3a1991c3e..b37bbf57f 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnConnectionParamBean.xml @@ -115,8 +115,8 @@ Java.Interop.JniPeerMembers - Gets the JNI peer member metadata for this type. - The JNI peer member metadata for this type. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + A instance that provides access to JNI peer-member information for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml index 835962221..fe4c0b73f 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParamBean.xml @@ -115,8 +115,8 @@ Java.Interop.JniPeerMembers - Gets the JNI peer member metadata for this type. - The JNI peer member metadata for this type. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + A instance that provides access to JNI peer-member information for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml index a41ce4146..ac8574ffd 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnManagerParams.xml @@ -217,8 +217,8 @@ Java.Interop.JniPeerMembers - Gets the JNI peer member metadata for this type. - The JNI peer member metadata for this type. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + A instance that provides access to JNI peer-member information for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml index e1313de68..c06b08e11 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnPerRouteBean.xml @@ -226,8 +226,8 @@ Java.Interop.JniPeerMembers - Gets the JNI peer member metadata for this type. - The JNI peer member metadata for this type. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + A instance that provides access to JNI peer-member information for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml index aa9451282..aec1461ac 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParamBean.xml @@ -115,8 +115,8 @@ Java.Interop.JniPeerMembers - Gets the JNI peer member metadata for this type. - The JNI peer member metadata for this type. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + A instance that provides access to JNI peer-member information for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. diff --git a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml index d0e72757e..b7ba48f94 100644 --- a/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml +++ b/docs/xml/Org.Apache.Http.Conn.Params/ConnRouteParams.xml @@ -188,8 +188,8 @@ Java.Interop.JniPeerMembers - Gets the JNI peer member metadata for this type. - The JNI peer member metadata for this type. + This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. + A instance that provides access to JNI peer-member information for this type. Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.