summaryrefslogtreecommitdiff
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* curl.1: remove mentions of really old version changesDaniel Stenberg2021-09-2812-27/+46
| | | | | | | | | | | | | | | | | | | To make the man page more readable, this change removes all references to changes in support/versions etc that happened before 7.30.0 from the curl.1 output file. 7.30.0 was released on Apr 12 2013. This particular limit is a bit arbitrary but was fairly easy to grep for. It is handled like this: the 'Added' keyword is only used in output if it refers to 7.30.0 or later. All occurances of "(Added in $VERSION)" in description will be stripped out if the mentioned $VERSION is from before 7.30.0. It is therefore important that the "Added in..." references are always written exactly like that - and on a single line, not split over two. This change removes about 80 version number references from curl.1, down to 138 from 218. Closes #7786
* gen.pl: insert the current date and version in generated man pageDaniel Stenberg2021-09-272-1/+16
| | | | | | Reported-by: Gisle Vanem Ref: #7780 Closes #7782
* CURLOPT_PREREQFUNCTION: add new callbackMax Dymond2021-09-275-0/+175
| | | | | | | | | | | | | | Triggered before a request is made but after a connection is set up Changes: - callback: Update docs and callback for pre-request callback - Add documentation for CURLOPT_PREREQDATA and CURLOPT_PREREQFUNCTION, - Add redirect test and callback failure test - Note that the function may be called multiple times on a redirection - Disable new 2086 test due to Windows weirdness Closes #7477
* KNOWN_BUGS: HTTP/2 connections through HTTPS proxy frequently stallDaniel Stenberg2021-09-271-0/+4
| | | | Closes #6936
* TODO: make configure use --cache-file more and betterDaniel Stenberg2021-09-271-0/+8
| | | | Closes #7753
* urlapi: add curl_url_strerror()i-ky2021-09-2713-21/+70
| | | | | | | | | | Add curl_url_strerror() to convert CURLUcode into readable string and facilitate easier troubleshooting in programs using URL API. Extend CURLUcode with CURLU_LAST for iteration in unit tests. Update man pages with a mention of new function. Update example code and tests with new functionality where it fits. Closes #7605
* libssh2: add SHA256 fingerprint supportMats Lindestam2021-09-268-10/+77
| | | | | | | Added support for SHA256 fingerprint in command line curl and in libcurl. Closes #7646
* examples/imap-append: fix end-of-data checkDaniel Stenberg2021-09-251-1/+1
| | | | | | Reported-by: Alexander Chuykov Fixes #7774 Closes #7775
* HTTP3.md: use 'autoreconf -fi' instead of buildconfMomoka Yamamoto2021-09-241-3/+3
| | | | | | buildconf is not used since #5853 Closes #7746
* HTTP-COOKIES.md: remove duplicate 'each'tlahn2021-09-241-1/+1
| | | | Closes #7772
* misc: fix typos in docs and commentsa13460542021-09-232-2/+2
| | | | | | | No user facing output from curl/libcurl is changed by this, just comments. Closes #7747
* THANKS: added names from the 7.79.1 releaseDaniel Stenberg2021-09-221-0/+5
|
* KNOWN_BUGS: connection migration doesn't workDaniel Stenberg2021-09-191-0/+5
| | | | Closes #7695
* TODO: Improve documentation about fork safetyDaniel Stenberg2021-09-161-0/+5
| | | | Closes #6968
* hsts: CURLSTS_FAIL from hsts read callback should fail transferDaniel Stenberg2021-09-161-1/+3
| | | | | | | | | | ... and have CURLE_ABORTED_BY_CALLBACK returned. Extended test 1915 to verify. Reported-by: Jonathan Cardoso Fixes #7726 Closes #7729
* FAQ: add GOPHERS + curl works on data, not filesDaniel Stenberg2021-09-151-4/+4
|
* THANKS: add contributors from 7.79.0 release cycleDaniel Stenberg2021-09-141-0/+26
|
* FAQ: add two dev related questionsDaniel Stenberg2021-09-141-0/+41
| | | | | | | | 8.1 Why does curl use C89? 8.2 Will curl be rewritten? Spell-checked-by: Paul Johnson Closes #7715
* RELEASE-PROCEDURE: add release dates from now to 8.0.0 in 2023Daniel Stenberg2021-09-131-4/+5
|
* SECURITY-PROCESS: tweak a little to match current practicesDaniel Stenberg2021-09-131-10/+11
| | | | Closes #7713
* write-out.d: clarify size_download/uploadDaniel Stenberg2021-09-121-2/+4
| | | | | | They show the number of "body" bytes transfered. Fixes #7702 Closes #7706
* docs: the security list is reached at security at curl.se nowDaniel Stenberg2021-09-102-5/+9
| | | | | | | Also update the FAQ section a bit to encourage users to rather submit security issues on hackerone than sending email. Closes #7689
* opts docs: unify phrasing in NAME headerDaniel Stenberg2021-09-09134-246/+246
| | | | | | | | | | | | | - avoid writing "set ..." or "enable/disable ..." or "specify ..." *All* options for curl_easy_setopt() are about setting or enabling things and most of the existing options didn't use that way of description. - start with lowercase letter, unless abbreviation. For consistency. - Some additional touch-ups Closes #7688
* copyrights: update copyright year rangesDaniel Stenberg2021-09-081-1/+1
|
* INTERNALS: c-ares has a new home: c-ares.orgDaniel Stenberg2021-09-071-1/+1
|
* docs: remove experimental mentions from HSTS and MQTTDaniel Stenberg2021-09-077-38/+8
| | | | | | Reported-by: Jonathan Cardoso Bug: https://github.com/curl/curl/pull/6700#issuecomment-913792863 Closes #7681
* examples/*hiperfifo.c: fix calloc arguments to match function protogit-bruh2021-09-063-3/+3
| | | | Closes #7678
* INTERNALS: bump c-ares requirement to 1.16.0Daniel Stenberg2021-09-061-1/+1
| | | | Since ba904db0705c93 we use ares_getaddrinfo, added in c-ares 1.16.0
* config.d: note that curlrc is used even when --configJay Satiro2021-09-051-2/+2
| | | | | | | Bug: https://github.com/curl/curl/pull/7666#issuecomment-912214751 Reported-by: Viktor Szakats Closes https://github.com/curl/curl/pull/7667
* CURLOPT_UNIX_SOCKET_PATH.3: remove nginx reference, add see alsoDaniel Stenberg2021-09-041-4/+5
| | | | Closes #7656
* opt-docs: verify man page sections + orderDaniel Stenberg2021-09-0415-54/+81
| | | | | | | | | | | | | | | | | | | | In every libcurl option man page there are now 8 mandatory sections that must use the right name in the correct order and test 1173 verifies this. Only 14 man pages needed adjustments. The sections and the order is as follows: - NAME - SYNOPSIS - DESCRIPTION - PROTOCOLS - EXAMPLE - AVAILABILITY - RETURN VALUE - SEE ALSO Reviewed-by: Daniel Gustafsson Closes #7656
* opt-docs: make sure all man pages have examplesDaniel Stenberg2021-09-0410-16/+215
| | | | | | | | | Extended manpage-syntax.pl (run by test 1173) to check that every man page for a libcurl option has an EXAMPLE section that is more than two lines. Then fixed all errors it found and added examples. Reviewed-by: Daniel Gustafsson Closes #7656
* get.d: provide more useful examplesDaniel Stenberg2021-09-041-0/+2
| | | | Closes #7668
* page-header: add GOPHERS, simplify wording in the 1st paraDaniel Stenberg2021-09-031-6/+5
| | | | Closes #7665
* curl.1: provide examples for each optionDaniel Stenberg2021-09-01244-50/+345
| | | | | | | | | | | The file format for each option now features a "Example:" header that can provide one or more examples that get rendered appropriately in the output. All options MUST have at least one example or gen.pl complains at build-time. This fix also does a few other minor format and consistency cleanups. Closes #7654
* KNOWN_BUGS: HTTP/3 doesn't support client certsDaniel Stenberg2021-08-301-0/+7
| | | | Closes #7625
* mailing lists: move from cool.haxx.se to lists.haxx.seDaniel Stenberg2021-08-303-6/+6
|
* curl_easy_setopt: tweak the string copy wordingDaniel Stenberg2021-08-261-5/+5
| | | | | | Reported-by: Yaobin Wen Fixes #7632 Closes #7634
* RELEASE-NOTES: syncedDaniel Stenberg2021-08-251-0/+1
|
* cmake: sync CURL_DISABLE optionsDon2021-08-251-6/+6
| | | | | | | | | | | | Adds the full listing of CURL_DISABLE options to the CMake build. Moves all option code, except for CURL_DISABLE_OPENSSL_AUTO_LOA_CONFIG which resides near OpenSSL configuration, to the same block of code. Also sorts the options here and in the cmake config header. Additionally sorted the CURL-DISABLE listing and fixed the CURL_DISABLE_POP3 option. Closes #7624
* KNOWN_BUGS: FTPS upload data loss with TLS 1.3Jay Satiro2021-08-251-0/+18
| | | | | | | Bug: https://github.com/curl/curl/issues/6149 Reported-by: Bylon2@users.noreply.github.com Closes https://github.com/curl/curl/pull/7623
* setopt: enable CURLOPT_IGNORE_CONTENT_LENGTH for hyperDaniel Stenberg2021-08-232-2/+2
| | | | | | | | | | | Since this option is also used for FTP, it needs to work to set for applications even if hyper doesn't support it for HTTP. Verified by test 1137. Updated docs to specify that the option doesn't work for HTTP when using the hyper backend. Closes #7614
* libcurl-errors.3: clarify two CURLUcode errorsDaniel Stenberg2021-08-231-2/+2
| | | | | | | | | | CURLUE_BAD_HANDLE and CURLUE_BAD_PARTPOINTER should be for "bad" or wrong pointers in a generic sense, not just for NULL pointers. Reviewed-by: Jay Satiro Ref: #7605 Closes #7611
* symbols-in-versions: fix CURLSSLBACKEND_QSOSSL last used versionJay Satiro2021-08-231-2/+2
| | | | | | | ... and also change the 'Removed' column name to 'Last' since that column is for the last version to contain the symbol. Closes https://github.com/curl/curl/pull/7609
* mksymbolsmanpage.pl: Fix showing symbol's last used versionJay Satiro2021-08-221-1/+1
| | | | | | | | Prior to this change the symbol's deprecated version was erroneously shown as its last used version. Bug: https://github.com/curl/curl/commit/4e53b94#commitcomment-55239509 Reported-by: i-ky@users.noreply.github.com
* mksymbolsmanpage.pl: match symbols case insenitivelyDaniel Stenberg2021-08-211-2/+2
| | | | | | | | Follow-up to 4e53b9430c750 which made this bug show. Reported-by: i-ky Bug: https://github.com/curl/curl/commit/4e53b9430c7504de8984796e2a2091ec16f27136#commitcomment-55239253 Closes #7607
* man pages: remove trailing whitespacesDaniel Stenberg2021-08-218-9/+3
| | | | | | | | | Extended test 1173 (via the manpage-syntax.pl script) to detect and warn for them. Ref: #7602 Reported-by: a1346054 on github Closes #7604
* config.d: escape the backslash properlyDaniel Stenberg2021-08-211-1/+1
| | | | Closes #7603
* KNOWN_BUGS: Renegotiate from server may cause hang for OpenSSL backendJay Satiro2021-08-181-0/+12
| | | | Closes https://github.com/curl/curl/issues/6785
* docs/BINDINGS: URL updateViktor Szakats2021-08-171-1/+1
|