From: Marcello Stanisci <stanisci.m@gmail.com>
Date: Mon, 13 May 2019 15:31:37 +0000 (+0200)
Subject: Comments
X-Git-Tag: v0.11.5~69
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=71b73f97b5897f68243e3ee27d0fd424ef025cb0;p=oweals%2Fgnunet.git

Comments
---

diff --git a/src/curl/curl.c b/src/curl/curl.c
index 0a6cde8a9..749094800 100644
--- a/src/curl/curl.c
+++ b/src/curl/curl.c
@@ -267,8 +267,11 @@ download_cb (char *bufptr, size_t size, size_t nitems, void *cls)
  * "Content-Type: application/json" header if @a add_json is set.
  *
  * @param ctx context to execute the job in
- * @param eh curl easy handle for the request, will
- *           be executed AND cleaned up
+ * @param eh curl easy handle for the request, will be executed AND
+ *           cleaned up.  NOTE: the handle should _never_ have gotten
+ *           any headers list, as that would then be ovverridden by
+ *           @a jcc.  Therefore, always pass custom headers as the
+ *           @a job_headers parameter.
  * @param job_headers extra headers to add for this request
  * @param jcc callback to invoke upon completion
  * @param jcc_cls closure for @a jcc