diff options
| -rw-r--r-- | doc/man7/libweb_http.7 | 25 |
1 files changed, 5 insertions, 20 deletions
diff --git a/doc/man7/libweb_http.7 b/doc/man7/libweb_http.7 index 5c01549..0963828 100644 --- a/doc/man7/libweb_http.7 +++ b/doc/man7/libweb_http.7 @@ -404,9 +404,9 @@ When .IR application/x-www-form-urlencoded -data is included, .I data -shall contain a null-terminated string with the user payload. Data must -be decoded by applications (see section -.BR "Handling application/x-www-form-urlencoded data" ). +shall contain a null-terminated string with the user payload. Such data can +be decoded with the functions provided by +.IR libweb_form (7). Otherwise, .I data shall be a null pointer. @@ -873,22 +873,6 @@ plus a .I size_t object containing the number of HTTP cookies in the request. -.SS Handling application/x-www-form-urlencoded data -Due to historical reasons, -.I libweb -treated -.IR application/x-www-form-urlencoded -data -as a binary blob. While this was changed to a null-terminated string in -order to allow applications to avoid unnecessary memory allocations, -.I libweb -still does not decode the data, instead forcing applications to do so. -Future versions of this library shall replace -.I "struct http_post" -member -.I data -with an array of structures containing key-value pairs, so that -applications no longer need to decode payload data by themselves. - .SH SEE ALSO .BR handler_alloc (3), .BR http_alloc (3), @@ -897,7 +881,8 @@ applications no longer need to decode payload data by themselves. .BR http_response_add_header (3), .BR http_cookie_create (3), .BR http_encode_url (3), -.BR http_decode_url (3). +.BR http_decode_url (3), +.BR libweb_form (7). .SH COPYRIGHT Copyright (C) 2023-2025 libweb contributors |