Merge pull request #2165 from ballerina-platform/execute-doc-update

Update API docs for HTTP method names

ballerina/caching_http_caching_client.bal

@@ -201,7 +201,8 @@ client isolated class HttpCachingClient {
 
     # Submits an HTTP request to a service with the specified HTTP verb.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `HttpFuture` that represents an asynchronous service invocation, or an error if the submission fails

ballerina/cookie_http_client.bal

@@ -177,7 +177,8 @@ client isolated class CookieClient {
     # The `CookieClient.submit()` function does not produce a `Response` as the result.
     # Rather, it returns an `HttpFuture`, which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `HttpFuture`, which represents an asynchronous service invocation or else an `http:ClientError` if the submission fails

ballerina/http_client.bal

@@ -118,7 +118,8 @@ client isolated class HttpClient {
     # The `HttpClient->submit()` function does not give out an `http:Response` as the result.
     # Rather, it returns an `http:HttpFuture` which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation, or else an `http:ClientError` if the submission fails

ballerina/http_client_endpoint.bal

@@ -375,7 +375,8 @@ public client isolated class Client {
     # The `Client->submit()` function does not give out a `http:Response` as the result.
     # Rather it returns an `http:HttpFuture` which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation or else an `http:ClientError` if the submission fails

ballerina/http_client_object.bal

@@ -207,7 +207,8 @@ public type ClientObject client object {
     # The `Client->submit()` function does not give out a `http:Response` as the result.
     # Rather it returns an `http:HttpFuture` which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request message or any payload of type `string`, `xml`, `json`, `byte[]`
     #             or `mime:Entity[]`

ballerina/http_secure_client.bal

@@ -142,7 +142,8 @@ client isolated class HttpSecureClient {
     # This wraps the `HttpSecureClient.submit()` function of the underlying HTTP remote functions provider. Add relevant authentication
     # headers to the request and send the request to actual network call.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation, or else an `http:ClientError` if the submission fails

ballerina/http_status_code_client.bal

@@ -373,7 +373,8 @@ public client isolated class StatusCodeClient {
     # The `Client->submit()` function does not give out a `http:Response` as the result.
     # Rather it returns an `http:HttpFuture` which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation or else an `http:ClientError` if the submission fails

ballerina/http_status_code_client_object.bal

@@ -207,7 +207,8 @@ public type StatusCodeClientObject client object {
     # The `Client->submit()` function does not give out a `http:Response` as the result.
     # Rather it returns an `http:HttpFuture` which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request message or any payload of type `string`, `xml`, `json`, `byte[]`
     #             or `mime:Entity[]`

ballerina/redirect_http_client.bal

@@ -170,7 +170,8 @@ client isolated class RedirectClient {
     # The `RedirectClient.execute()` sends an HTTP request to a service with the specified HTTP verb. Redirect will be
     # performed only for HTTP methods.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - Resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - The response or an `http:ClientError` if failed to establish the communication with the upstream server
@@ -246,7 +247,8 @@ client isolated class RedirectClient {
     # The `RedirectClient.submit()` function does not give out a `Response` as the result,
     # rather it returns an `HttpFuture` which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation or else an `http:ClientError` if the submission fails

ballerina/resiliency_failover_client.bal

@@ -413,7 +413,8 @@ public client isolated class FailoverClient {
     # return an `http:Response` as the result. Rather it returns an `http:HttpFuture` which can be used for subsequent interactions
     # with the HTTP endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation or else an `http:ClientError` if the submission

ballerina/resiliency_http_circuit_breaker.bal

@@ -306,7 +306,8 @@ client isolated class CircuitBreakerClient {
     # The `CircuitBreakerClient.submit()` function does not give out a `Response` as the result.
     # Rather it returns an `http:HttpFuture` which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation or else an `http:ClientError` if the submission

ballerina/resiliency_http_retry_client.bal

@@ -130,7 +130,8 @@ client isolated class RetryClient {
     # the underlying HTTP remote function in a way to provide retrying functionality for a given endpoint to recover
     # from network level failures.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - Resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - The response or an `http:ClientError` if failed to establish the communication with the upstream server
@@ -217,7 +218,8 @@ client isolated class RetryClient {
     # The `RetryClient.submit()` function does not give out a `http:Response` as the result.
     # Rather it returns an `http:HttpFuture`, which can be used to do further interactions with the endpoint.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation or else an `http:ClientError` if the submission fails

ballerina/resiliency_load_balance_client.bal

@@ -349,7 +349,8 @@ public client isolated class LoadBalanceClient {
 
     # The submit implementation of the LoadBalancer Connector.
     #
-    # + httpVerb - The HTTP verb value
+    # + httpVerb - The HTTP verb value. The HTTP verb is case-sensitive. Use the `http:Method` type to specify the
+    #              the standard HTTP methods.
     # + path - The resource path
     # + message - An HTTP outbound request or any allowed payload
     # + return - An `http:HttpFuture` that represents an asynchronous service invocation or else an `http:ClientError` if the submission