From 5d6eeb5d1d6d65597d749f7ec5240c034cf1c27c Mon Sep 17 00:00:00 2001
From: Deomid Ryabkov <rojer@cesanta.com>
Date: Wed, 6 Jan 2016 21:37:04 +0000
Subject: [PATCH] Add a note about Content-Type for form submissions
PUBLISHED_FROM=6079258be24fa0255f5a58e4d364be224435394b
---
mongoose.h | 12 +++++++++---
1 file changed, 9 insertions(+), 3 deletions(-)
diff --git a/mongoose.h b/mongoose.h
index ac033a4eb..d53f4f986 100644
--- a/mongoose.h
+++ b/mongoose.h
@@ -1804,15 +1804,21 @@ int mg_http_create_digest_auth_header(char *buf, size_t buf_len,
* Host headers. `extra_headers` is an extra HTTP headers to send, e.g.
* `"User-Agent: my-app\r\n"`.
* If `post_data` is NULL, then GET request is created. Otherwise, POST request
- * is created with the specified POST data. Examples:
+ * is created with the specified POST data. Note that if the data being posted
+ * is a form submission, the `Content-Type` header should be set accordingly
+ * (see example below).
+ *
+ * Examples:
*
* [source,c]
* ----
* nc1 = mg_connect_http(mgr, ev_handler_1, "http://www.google.com", NULL,
* NULL);
* nc2 = mg_connect_http(mgr, ev_handler_1, "https://github.com", NULL, NULL);
- * nc3 = mg_connect_http(mgr, ev_handler_1, "my_server:8000/form_submit/",
- * NULL, "var_1=value_1&var_2=value_2");
+ * nc3 = mg_connect_http(
+ * mgr, ev_handler_1, "my_server:8000/form_submit/",
+ * "Content-Type: application/x-www-form-urlencoded\r\n",
+ * "var_1=value_1&var_2=value_2");
* ----
*/
struct mg_connection *mg_connect_http(struct mg_mgr *mgr,
--
GitLab