On 16.01.2021 at 23:00 Daniel Stenberg wrote: > We should probably make this clear in the docs somewhere, but I'm not really > sure how or where...
Thanks for clarification! Here are some suggestions concerning better documentation from a user's point of view: 1) Does CURLOPT_MIMEPOST imply CURLOPT_UPLOAD? If it does, it should be mentioned in one of the man pages because as it stands, it's unclear whether CURLOPT_UPLOAD has to be set as well when CURLOPT_MIMEPOST has been set already or whether the two are mutually exclusive. --OR-- 2) If setting CURLOPT_UPLOAD to 1 should only be done when supplying the data via CURLOPT_READFUNCTION it should be mentioned on the man page of CURLOPT_UPLOAD that setting CURLOPT_UPLOAD to 1 should only be done if one intends to use CURLOPT_READFUNCTION to provide the data and not use other means of providing the data like through CURLOPT_MIMEPOST. Currently this is somewhat unclear because all that CURLOPT_UPLOAD says is that "the CURLOPT_READDATA and CURLOPT_INFILESIZE or CURLOPT_INFILESIZE_LARGE options are also interesting for uploads" which is very blurry because it doesn't make it clear whether setting CURLOPT_UPLOAD to 1 will force the user to use CURLOPT_READFUNCTION... -- Best regards, Andreas Falkenhahn mailto:andr...@falkenhahn.com ------------------------------------------------------------------- Unsubscribe: https://cool.haxx.se/list/listinfo/curl-library Etiquette: https://curl.se/mail/etiquette.html