GUACAMOLE-1174: Clarify behavior of URL parameter appending function.

This commit is contained in:
Michael Jumper 2021-02-21 14:15:17 -08:00
parent 5428ac5057
commit 7f55399304

View File

@ -50,8 +50,11 @@ int guac_kubernetes_escape_url_component(char* output, int length,
const char* str); const char* str);
/** /**
* Append the parameter to the endpoint path. * Appends the given query parameter and value to the given buffer. If the
* Value within the path will be URL-escaped as necessary. * buffer does not already contain the '?' character denoting the start of the
* query string, it will be added. If the buffer already contains a query
* string, a '&' character will be added before the new parameter. The
* parameter value will automatically be URL-escaped as necessary.
* *
* @param buffer * @param buffer
* The buffer which should receive the parameter. It could contain the endpoint path. * The buffer which should receive the parameter. It could contain the endpoint path.
@ -61,7 +64,8 @@ int guac_kubernetes_escape_url_component(char* output, int length,
* The number of bytes available in the given buffer. * The number of bytes available in the given buffer.
* *
* @param param_name * @param param_name
* The name of the parameter. * The name of the parameter. If the parameter name contains characters
* with special meaning to URLs, it must already be URL-escaped.
* *
* @param param_value * @param param_value
* The value of the parameter. * The value of the parameter.