https://ec.haxx.se/building-source.html

Original:

On Linux and Unix-like systems

[...]

The configure based build is arguably the more mature and more convering
build system and should probably be considered the default one.

"convering" -- looks like this word is wrong. If so, please correct.

https://ec.haxx.se/libcurl-proxies.html

Original:

Proxy environment variables
[...]

The proxy above example is for HTTP, but can of course also set
ftp_proxy, https_proxy, and so on for the specific protocols you want to
proxy.

It is better to rephrase "The proxy above example" as "The above proxy
example" for clarity.

Hello, Mr. Daniel.
I am a developer from China. Can I fork this repository and translate it into Chinese? In China, many developers have poor English skills. I think this will help more developers use cURL effectively. Of course, the author's signature is still you. I'm just doing a translation job myself. Thank you. Look forward to your reply.

https://ec.haxx.se/protocols-curl.html

Original:

SMB 
The Server Message Block (SMB) protocol is also known as CIFS. It is
a an application-layer network protocol mainly used for providing shared
access to files, printers, and serial ports and miscellaneous
communications between nodes on a network. SMB servers and clients use
TCP port 445.

In second sentence:

"It is a an" should be "It is an".

https://ec.haxx.se/usingcurl-smtp.html

Original:

curl supports sending data to a an SMTP server, which combined with the
right set of command line options makes an email get sent to a set of
receivers of your choice.

"to a an SMTP server" should be "to a SMTP server".

I'm reading the most recent PDF version of the book in the Preview app on macOS (10.13.6). When I highlight any length of text — to look-up via Dictionary, or copy and paste — it is not detected. It is instead treated as an empty string. I've confirmed that this behavior is not present in other PDF documents.

On page 94 the book says the following,

…or even have curl read the string from stdin if you use '-' as filename:
curl -w @- http://example.com/

I tried executing the command and I am still stuck with the input. There is some sort of continuity which is missing that says how to get the command to resume after giving standard input.

The section "Using curl/Proxies/Captive portals" begins with the following note:

(these are not proxies but in the way)

But "in the way" means "blocking the path, literally or figuratively", and I'm pretty sure that wasn't the intention.

"... in a way" would be better, but I think the following note would be clearer and almost as short:

(these are not proxies but the idea is similar)

https://ec.haxx.se/http-browserlike.html

Original:

Figure out what the browser does

[...]

The slightly more effective way, that also works even for the cases when
the page is shock-full of opfuscated javascript, is to run the browser
and monitor what HTTP operations it performs.

"opfuscated" should be "obfuscated".

https://ec.haxx.se/sourcecode-layout.html

original:

docs/libcurl
All libcurl functions have their own man pages in individual files with .3 extensions, using
nroff format, in this directory. The are also a few other files that are described below.

In the above "The are" in the last line should be "There are".

Using curl
FTP
Two connections

You can also explicitly ask curl to not use EPRT (which is a slightly newer command than PORT) with the --no-epsv command-line option.

Probably meant the command: --no-eprt

https://ec.haxx.se/libcurl-names.html

Original:

Name server options
[...]

This is limited to c-ares build purely because these are powers that are
not available when the standard system calls for name name resolving are
used.

"for name name resolving" should be "for name resolving".

https://ec.haxx.se/libcurl-names.html

Original:

Name resolving
[...]

libcurl tries hard to re-use an existing connection rather than to
create and connection a new one.

"and connection a new one" should be "and connect to a new one".

https://github.com/bagder/everything-curl/blob/master/curl-users.md

The curl command-line tool and the libcurl library are available for download for most operating systems via the curl web site, they are provided via third party installers to a bunch and and they come installed by default with yet more operating systems.

"and and" --> "and"

As in curl-name.md。 The WAV file link returns a 404 now.

Headers "Remove a header" and "Provide a header without contents" based on content should probably be swapped around.

https://ec.haxx.se/http-requests.html

Original:

Time conditions

[...]

A useful condition is time. For exanmple, ask the server to only deliver
a response if the resource has been modified after a particular time:

"For exanmple" should be "For example".

https://ec.haxx.se/libcurl-http-auth.html

Original:

Digest

Another authentication method is called Digest. This method has an advantage that

The above sentence is abruptly ending. Please complete it.

https://github.com/bagder/everything-curl/blob/master/curl-bugs.md

We do not test everything and even when we try to test things there will always be subtlqe details that get through and that we, sometimes years after the fact, figure out were wrong.

"subtlqe" --> "subtle"

https://github.com/bagder/everything-curl/blob/master/usingcurl-downloads.md#resuming-and-ranges

source

when you only want 1000 bytes from offset 100 to 
avoid having to download the entire huge remote file:

	curl --range 100-1999 http://example.com/bigfile

error ❌?

1000 bytes !== 1999 - 100

Ocaml curl binding https://sourceforge.net/projects/ocurl/ hasn't been updated since 2012.

Here is updated info from Ocaml package manager opam.

opam show ocurl

<><> ocurl: information on all versions <><><><><><><><><><><><><><><><><><><><>
name         ocurl
all-versions 0.5.4  0.5.5  0.5.6  0.6.0  0.6.1  0.7.0  0.7.1  0.7.2  0.7.5  0.7.6  0.7.7  0.7.8  0.7.9  0.7.10  0.8.0  0.8.1  0.8.2

<><> Version-specific details <><><><><><><><><><><><><><><><><><><><><><><><><>
version       0.8.2
repository    default
url.src:      "http://ygrek.org.ua/p/release/ocurl/ocurl-0.8.2.tar.gz"
url.checksum: "md5=194b65b5abb1e32be17f4d5c8c9a8627"
homepage:     "http://ygrek.org.ua/p/ocurl/"
bug-reports:  "https://github.com/ygrek/ocurl/issues"
dev-repo:     "git://github.com/ygrek/ocurl.git"
authors:      "Lars Nilsson" "ygrek"
maintainer:   "[email protected]"
license:      "MIT"
tags:         "org:ygrek" "clib:curl"
flags:        light-uninstall
depends:      "ocaml" {>= "4.02.0"} "ocamlfind" {build} "base-unix" "conf-libcurl"
depopts:      "lwt"
synopsis      Bindings to libcurl
description   Client-side URL transfer library, supporting HTTP and a multitude of
              other network protocols (FTP/SMTP/RTSP/etc).

https://ec.haxx.se/libcurl-drive-multi-socket.html

Original:

How to start everything
[...]

To kick it all off, you tell libcurl it timed out (because all easy
handles start out with a short timeout) which will make libcurl call the
callbacks to set things up and from then on you can can just let your
event system drive:

"you can can just" should be "you can just".

https://ec.haxx.se/http-browserlike.html

Original:

Web logins and sessions

[...]

Many login pages even send you a session cookie already when presenting
the login, and since you often need to extract the hidden fields from
the <form> tag anyway, you could so something like this first:

"you could so something" should be "you could do something".

http-ranges
Get 200 bytes from index 0 and 200 bytes from index 1000:
curl -r 0-199,1000-199 http://example.com/
->
curl -r 0-199,1000-1199 http://example.com/

https://ec.haxx.se/usingcurl-copyas.html

Original:

Not perfect

These methods all give you a command line to reproduce their HTTP
transfers. You will also learn they they are still often not the perfect
solution to your problems.

In the second sentence:

"You will also learn they they are" should be "You will also learn they are".

HTTP with libcurl
HTTP request
Request method

       curl_easy_setupt(curl, CURLOPT_CUSTOMREQUEST, "DELETE");
       curl_easy_setupt(curl, CURLOPT_URL, "https://example.com/file.txt");

I think this example should be written like that:
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/file.txt");

Page 114 again, section "Keep alive", it says curl defaults to 60 seconds for the "TCP pings". Page 116 section "Keep connections alive" says "the default value is usually set to 7200, which is two full hours". So is it 60 or 7200 seconds?

Page 100, under section "compression", paragraph starting "With this option enabled (and if the server support [sic] it)" should probably read "and if the server supports it".

Keep up the good work; excellent documentation, especially considering what passes elsewhere for documentation these days.

alt-svc support was just merged and should be added in the book.

In protocols-curl.md, the TCP port used by SMB should be 445, not 485

curl not work on win7 ultimate?

wait 25 min and nothing happend

https://ec.haxx.se/http-browserlike.html

Original:

Cookies

A lot of the web today works with a user name and password login propt
somewhere.

"propt" should be "prompt".

Last paragraph of page 216, starting "When you do multiple ... in the same curl_multi_perform invoke [sic] and then you might need", could be improved, presumably to something like "in the same curl_multi_perform invocation and then you might need".

Really good documentation; these all just minor mistakes.

Page 212 in the section "Drive" transfers, "2. The 'multi' interface is for when you want to do more than one transfer at the same time, or you just want an [sic] non-blocking transfer mechanism.". Would be better as "or you just want a non-blocking transfer".

The first initial HTTP/3 experimental code has been merged and can do transfers. Time to add some blurb to the book about it...

I'm not sure if an issue is the way to do this, but… We're currently using the former version, but the latter is more standard. Of course, every project has it's own style, so I wanted to ask. In the meantime I've made a branch of my fork with the change: bookofportals/everything-curl@3ffb0b8. @bagder: which one should we use?

https://ec.haxx.se/usingcurl-tls.html

Original:

Ciphers

When curl connections to a TLS server, it negotiates how to speak the
protocol and that negotiation involves several parameters and variables
that both parties need to agree to.

"When curl connections to a TLS server" should be "When curl connects to a TLS server".

Page 114 in section "Keep alive", paragraph starting "At the same time, lots of network equipments [sic] such as", should probably be "lots of network equipment such as".

README.md says "This document is licensed under the [Creative Commons Attribution 4.0 license]" but the LICENSE file says public domain. Which is correct?

Gitbooks doesn't seem to provide any index feature so finding the chapter again where for example a certain curl option is discussed, is really hard.

I need to write a script to generate an index in markdown to include as the final "chapter".

https://ec.haxx.se/libcurl-drive-multi-socket.html

Original:

Pick one

[...]

libevent, libev are libuv three popular ones but you can also go
directly to your operating system's native solutions such as epoll,
kqueue, /dev/poll, pollset, Event Completion or I/O Completion Ports.

"libevent, libev are libuv" should be "libevent, libev and libuv are
the".

https://ec.haxx.se/usingcurl-smtp.html

Original:

When sending SMTP with curl, there are a two necessary command line
options that must be used.

"there are a two" should be "there are two"

https://ec.haxx.se/http-browserlike.html

Original:

Figure out what the browser does

[...]

Those copied curl command lines are often not goood enough though since
they tend to copy exactly that request, while you probably want to be a
bad bit more dynamic so that you can reproduce the same operation and
not just resend the verbatim request.

"goood" should be "good".

"a bad bit more" should be "a tad bit more"

Formats:

• PDF
• Mobi
• ePub

are broken because of gitbook:

 This doesn't happen often, but it looks like something is broken. Hitting the back button and trying again might be your best bet. If that doesn't work you can head back to the homepage.

There might be more information on our status page which is reporting All Systems Operational. 

In web version only the first 4 pages are available.

Other pages are broken:

> curl https://ec.haxx.se/curl-comm.html
curl: (92) HTTP/2 stream 1 was not closed cleanly: PROTOCOL_ERROR (err 1)

https://ec.haxx.se/libcurl-http-auth.html

Original:

HTTP authentication

libcurl supports a wide varity of HTTP authentication schemes.

"varity" --> "variety".

https://ec.haxx.se/http-browserlike.html

Original:

Web logins and sessions

[...]

It is generated by the site itself, and for your curl login to succeed,
youy need extract that value and use that in your POST submission
together with the rest of the data.

"youy need extract" should be "you need to extract".

https://ec.haxx.se/libcurl-proxies.html

Original:

Proxy environment variables
[...]

So if you want to tell curl to use a proxy when access a HTTP server,
you set the 'http_proxy' environment variable.

"when access a HTTP server" should be "when accessing a HTTP server".

It is coming in the 7.66.0 release and deserves a section...

https://ec.haxx.se/usingcurl-tls.html

Original:

--tlsv1.0    TLS >= version 1.0
--tlsv1.1    TLS >= version 1.1
--tlsv1.2    TLS >= version 1.2
--tlsv1.3    TLS >= version 1.3

If I am not wrong, it should be:

--tlsv1.0       Use TLSv1.0
--tlsv1.1       Use TLSv1.1
--tlsv1.2       Use TLSv1.2
--tlsv1.3       Use TLSv1.3

Reference:

$ curl -h | grep -e '--tlsv1'
 -1, --tlsv1         Use TLSv1.0 or greater
     --tlsv1.0       Use TLSv1.0
     --tlsv1.1       Use TLSv1.1
     --tlsv1.2       Use TLSv1.2
     --tlsv1.3       Use TLSv1.3

https://ec.haxx.se/building-tls.html

Original

WolfSSL

[...]

./configure --with-cyassl=/home/user/installed/nss --without-ssl

The above line should be:

./configure --with-cyassl=/home/user/installed/wolfssl --without-ssl