From 594917d7b2170f7e946e2cc7e9c5de3f6e4775be Mon Sep 17 00:00:00 2001 From: Xavier Del Campo Romero Date: Tue, 7 Oct 2025 23:33:20 +0200 Subject: libweb_http.7: Remove obsolete information --- doc/man7/libweb_http.7 | 25 +++++-------------------- 1 file 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 -- cgit v1.2.3