summaryrefslogtreecommitdiff
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* gen.pl: replace leading single quotes with \(aqbagder/curl1-single-quotesDaniel Stenberg2021-11-015-4/+6
| | | | | | | | | ... and allow single quotes to be used "normally" in the .d files. Makes the output curl.1 use better nroff. Reported-by: Sergio Durigan Junior Fixed #7928
* smooth-gtk-thread.c: enhance the mutex lock useDaniel Stenberg2021-11-011-39/+31
| | | | | | Reported-by: ryancaicse on github Fixes #7926 Closes #7931
* CURLOPT_HSTSWRITEFUNCTION.3: using CURLOPT_HSTS_CTRL is requiredJonathan Cardoso Machado2021-10-291-0/+3
| | | | Closes #7923
* opt-manpages: use 'Added in' instead of 'Since'Daniel Stenberg2021-10-274-4/+4
| | | | Closes #7913
* docs: fix typo in CURLOPT_TRAILERFUNCTION exampleKerem Kat2021-10-261-1/+1
| | | | Closes #7910
* docs/HYPER: remove some remaining issues, add HTTP/0.9 limitationDaniel Stenberg2021-10-261-6/+2
|
* hyper: disable test 1294 since hyper doesn't allow such crazy headersDaniel Stenberg2021-10-251-0/+1
| | | | Closes #7905
* Makefile.m32: fix to not require OpenSSL with -libssh2 or -rtmp optionsViktor Szakats2021-10-251-3/+8
| | | | | | | | | | | | | | | Previously, -libssh2/-rtmp options assumed that OpenSSL is also enabled (and then failed with an error when not finding expected OpenSSL headers), but this isn't necessarly true, e.g. when building both libssh2 and curl against Schannel. This patch makes sure to only enable the OpenSSL backend with -libssh2/-rtmp, when there was no SSL option explicitly selected. - Re-implement the logic as a single block of script. - Also fix an indentation while there. Assisted-by: Jay Satiro Closes #7895
* docs: consistent use of "Added in"Daniel Stenberg2021-10-2528-41/+41
| | | | | Make them all say "Added in [version]" without using 'curl' or 'libcurl' in that phrase.
* man pages: require all to use the same section header orderDaniel Stenberg2021-10-2573-264/+676
| | | | | | | | | This is the same order we already enforce among the options' man pages: consistency is good. Add lots of previously missing examples. Adjust the manpage-syntax script for this purpose, used in test 1173. Closes #7904
* docs/HTTP3: improve build instructionsDavid Hu2021-10-251-7/+14
| | | | | | | | | | | | | | 1. If writing to a system path if the command is not prefixed with `sudo` it will cause a permission denied error 2. The patched OpenSSL branch has been updated to `openssl-3.0.0+quic` to match upstream OpenSSL version. 3. We should not disable GnuTLS docs. Updated some commands about `make install` Closes #7842
* docs: provide "RETURN VALUE" section for more func manpagesDaniel Stenberg2021-10-254-4/+11
| | | | | | Three were missing, one used a non-standard name for the header. Closes #7902
* curl_multi_socket_action.3: add a "RETURN VALUE" sectionJay Satiro2021-10-251-0/+3
| | | | | | | | | .. because it may not be immediately clear to the user what curl_multi_socket_action returns. Ref: https://curl.se/mail/lib-2021-10/0035.html Closes https://github.com/curl/curl/pull/7901
* hyper: does not support disabling CURLOPT_HTTP_TRANSFER_DECODINGDaniel Stenberg2021-10-222-1/+3
| | | | | | | | Simply because hyper doesn't have this ability. Mentioned in docs now. Skip test 326 then Closes #7889
* INSTALL: update symbol hiding optionÉrico Nogueira2021-10-221-1/+1
| | | | | | | --enable-hidden-symbols was deprecated in 9e24b9c7afbcb81120af4cf3f6cdee49a06d8224. Closes #7890
* URL-SYNTAX: add IMAP UID SEARCH exampleJay Satiro2021-10-211-5/+24
| | | | | | | | | | | | | - Explain the difference between IMAP search via URL (which returns message sequence numbers) and IMAP search via custom request (which can return UID numbers if prefixed with UID, eg "UID SEARCH ..."). Bug: https://github.com/curl/curl/issues/7626 Reported-by: orycho@users.noreply.github.com Ref: https://github.com/curl/curl/issues/2789 Closes https://github.com/curl/curl/pull/7881
* manpage: adjust the asterisk in some SYNOPSIS sectionsDaniel Stenberg2021-10-204-10/+11
| | | | Closes #7884
* curl_multi_perform.3: polish wordingDaniel Stenberg2021-10-201-66/+25
| | | | | | | | | | | | | - simplify the example by using curl_multi_poll - mention curl_multi_add_handle in the text - cut out the description of pre-7.20.0 return code behavior - that version is now more than eleven years old and is basically no longer out there - adjust the "typical usage" to mention curl_multi_poll Closes #7883
* docs/THANKS: removed on requestDaniel Stenberg2021-10-201-1/+0
|
* FAQ: polish the explanation of libcurlDaniel Stenberg2021-10-201-2/+2
|
* curl_easy_perform.3: minor wording tweakDaniel Stenberg2021-10-201-3/+3
|
* examples/htmltidy: correct wrong printf() useDaniel Stenberg2021-10-151-4/+4
| | | | | | | | | ... and update the includes to match how current htmltidy wants them used. Reported-by: Stathis Kapnidis Fixes #7860 Closes #7861
* docs/Makefile.am: repair 'make html'Daniel Stenberg2021-10-141-1/+1
| | | | | | by removing index.html which isn't around anymore Closes #7853
* urlapi: URL decode percent-encoded host namesDaniel Stenberg2021-10-111-1/+9
| | | | | | | | | | | | | | | | | | | | | | The host name is stored decoded and can be encoded when used to extract the full URL. By default when extracting the URL, the host name will not be URL encoded to work as similar as possible as before. When not URL encoding the host name, the '%' character will however still be encoded. Getting the URL with the CURLU_URLENCODE flag set will percent encode the host name part. As a bonus, setting the host name part with curl_url_set() no longer accepts a name that contains space, CR or LF. Test 1560 has been extended to verify percent encodings. Reported-by: Noam Moshe Reported-by: Sharon Brizinov Reported-by: Raul Onitza-Klugman Reported-by: Kirill Efimov Fixes #7830 Closes #7834
* CURLOPT_HTTPHEADER.3: add descripion for specific headersDaniel Stenberg2021-10-081-0/+10
| | | | | | | Settting Host: or Transfer-Encoding: chunked actually have special meanings to libcurl. This change tries to document them Closes #7829
* CURLOPT_MAXLIFETIME_CONN: maximum allowed lifetime for conn reuseJeffrey Tolar2021-10-066-4/+75
| | | | | | | | | ... and close connections that are too old instead of reusing them. By default, this behavior is disabled. Bug: https://curl.se/mail/lib-2021-09/0058.html Closes #7751
* docs/examples: add missing binaries to gitignoreDaniel Gustafsson2021-10-061-0/+2
| | | | | | | | Commit f65d7889b added getreferrer, and commit ae8e11ed5 multi-legacy, both of which missed adding .gitignore clauses for the built binaries. Closes #7817 Reviewed-by: Daniel Stenberg <daniel@haxx.se>
* HTTP3: fix the HTTP/3 Explained book linkJosip Medved2021-10-051-1/+1
| | | | Closes #7813
* BINDINGS: URL updatesRyan Mast2021-10-041-7/+7
| | | | | | For cpr, BBHTTP, Eiffel, Harbour, Haskell, Mono, and Rust Closes #7809
* sasl: binary messagesPatrick Monnerat2021-10-021-5/+0
| | | | | | | | | | Capabilities of sasl module are extended to exchange messages in binary as an alternative to base64. If http authentication flags have been set, those are used as sasl default preferred mechanisms. Closes #6930
* tool_listhelp: easier to generate with gen.plDaniel Stenberg2021-09-301-0/+42
| | | | | | | | | | | | | | | tool_listhelp.c is now a separate file with only the command line --help output, exactly as generated by gen.pl. This makes it easier to generate updates according to what's in the docs/cmdline-opts docs. cd $srcroot/docs/cmdline-opts ./gen.pl listhelp *.d > $srcroot/src/tool_listhelp.c With a configure build, this also works: make -C src listhelp Closes #7787
* gen.pl: make the output date format work betterDaniel Stenberg2021-09-301-1/+1
| | | | | | | | | | | Follow-up to 15910dfd143dd The previous strftime format used didn't work correctly on Windows, so change to %B %d %Y which today looks like "September 29 2021". Reported-by: Gisle Vanem Bug: #7782 Closes #7793
* externalsocket: use WinSock 2.2Marcel Raad2021-09-281-1/+1
| | | | | | That's the only version we support. Closes https://github.com/curl/curl/pull/7778
* cmdline-opts: made the 'Added:' field mandatoryDaniel Stenberg2021-09-28111-15/+124
| | | | | | | | Since "too old" versions are no longer included in the generated man page, this field is now mandatory so that it won't be forgotten and then not included in the documentation. Closes #7786
* 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
|