From b78e6267b2905afcf856f3771c1f3b3ffac72862 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 04:05:54 -0500 Subject: [PATCH 1/2] Document HTTP parameter contracts Refs #283 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../AbstractHttpParams.xml | 12 +++--- .../BasicHttpParams.xml | 37 ++++++++----------- 2 files changed, 22 insertions(+), 27 deletions(-) diff --git a/docs/xml/Org.Apache.Http.Params/AbstractHttpParams.xml b/docs/xml/Org.Apache.Http.Params/AbstractHttpParams.xml index 474048548..ebfe8de1f 100644 --- a/docs/xml/Org.Apache.Http.Params/AbstractHttpParams.xml +++ b/docs/xml/Org.Apache.Http.Params/AbstractHttpParams.xml @@ -173,7 +173,7 @@ the parent name. the default value. Returns a parameter value with the given name. - To be added. + a that represents the value of the parameter. 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. @@ -210,7 +210,7 @@ the parent name. the default value. Returns a parameter value with the given name. - To be added. + a that represents the value of the parameter. 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. @@ -247,7 +247,7 @@ the parent name. the default value. Returns an parameter value with the given name. - To be added. + an that represents the value of the parameter. 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. @@ -284,7 +284,7 @@ the parent name. the default value. Returns a parameter value with the given name. - To be added. + a that represents the value of the parameter. 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. @@ -369,7 +369,7 @@ parameter name Checks if a boolean parameter is not set or false. - To be added. + true if the parameter is either not set or set to false, false if it is set to true. 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. @@ -404,7 +404,7 @@ parameter name Checks if a boolean parameter is set to true. - To be added. + true if the parameter is set to true, false if it is not set or set to false. 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.Params/BasicHttpParams.xml b/docs/xml/Org.Apache.Http.Params/BasicHttpParams.xml index f37d098e4..93b3d785b 100644 --- a/docs/xml/Org.Apache.Http.Params/BasicHttpParams.xml +++ b/docs/xml/Org.Apache.Http.Params/BasicHttpParams.xml @@ -159,7 +159,7 @@ Creates a copy of these parameters. - To be added. + a new set of parameters holding a copy of the local parameters in this object. 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. @@ -189,10 +189,9 @@ - To be added. - - - To be added. + the parent name. + Obtains the value of the given parameter. + an object that represents the value of the parameter, null if the parameter is not set or if it is explicitly set to null. 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. @@ -222,10 +221,9 @@ - To be added. - - - To be added. + parameter name + Checks whether the parameter is set. + true if the parameter is defined and non-null. 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. @@ -255,10 +253,9 @@ - To be added. - - - To be added. + parameter name + Checks whether the parameter is set in this object. + true if the parameter is defined and non-null. 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. @@ -326,10 +323,9 @@ - To be added. - - - To be added. + parameter name + Removes the parameter with the specified name. + true if the parameter existed and was removed; otherwise, false. 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. @@ -360,10 +356,9 @@ - To be added. - To be added. - - + parameter name + parameter value + Assigns the value to the parameter with the given name. To be added. 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 d6e20f4205f6817e96c1617c2e45698d2ebc1398 Mon Sep 17 00:00:00 2001 From: Jonathan Peppers Date: Fri, 14 Aug 2026 04:16:45 -0500 Subject: [PATCH 2/2] Correct HTTP parameter contracts Refs #283 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../AbstractHttpParams.xml | 24 +++++++++---------- .../BasicHttpParams.xml | 4 ++-- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/xml/Org.Apache.Http.Params/AbstractHttpParams.xml b/docs/xml/Org.Apache.Http.Params/AbstractHttpParams.xml index ebfe8de1f..2c3640d74 100644 --- a/docs/xml/Org.Apache.Http.Params/AbstractHttpParams.xml +++ b/docs/xml/Org.Apache.Http.Params/AbstractHttpParams.xml @@ -170,10 +170,10 @@ - the parent name. + parameter name. the default value. - Returns a parameter value with the given name. - a that represents the value of the parameter. + Returns the Boolean parameter value with the given name, or the default value when it is not explicitly set. + The parameter value, or when it is not explicitly 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. @@ -207,10 +207,10 @@ - the parent name. + parameter name. the default value. - Returns a parameter value with the given name. - a that represents the value of the parameter. + Returns the Double parameter value with the given name, or the default value when it is not explicitly set. + The parameter value, or when it is not explicitly 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. @@ -244,10 +244,10 @@ - the parent name. + parameter name. the default value. - Returns an parameter value with the given name. - an that represents the value of the parameter. + Returns the Integer parameter value with the given name, or the default value when it is not explicitly set. + The parameter value, or when it is not explicitly 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. @@ -281,10 +281,10 @@ - the parent name. + parameter name. the default value. - Returns a parameter value with the given name. - a that represents the value of the parameter. + Returns the Long parameter value with the given name, or the default value when it is not explicitly set. + The parameter value, or when it is not explicitly 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. diff --git a/docs/xml/Org.Apache.Http.Params/BasicHttpParams.xml b/docs/xml/Org.Apache.Http.Params/BasicHttpParams.xml index 93b3d785b..36d41bae6 100644 --- a/docs/xml/Org.Apache.Http.Params/BasicHttpParams.xml +++ b/docs/xml/Org.Apache.Http.Params/BasicHttpParams.xml @@ -189,7 +189,7 @@ - the parent name. + parameter name. Obtains the value of the given parameter. an object that represents the value of the parameter, null if the parameter is not set or if it is explicitly set to null. @@ -359,7 +359,7 @@ parameter name parameter value Assigns the value to the parameter with the given name. - To be added. + This parameter collection. 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.