Comments

diff --git a/src/curl/curl.c b/src/curl/curl.c
index 0a6cde8a980dedc403ce0b2ad0d64f56aeaa0b96..749094800b1b7e8b3894827e8ca1c8889191ef13 100644 (file)
--- 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