diff options
Diffstat (limited to 'docs/MANUAL.md')
| -rw-r--r-- | docs/MANUAL.md | 36 |
1 files changed, 18 insertions, 18 deletions
diff --git a/docs/MANUAL.md b/docs/MANUAL.md index ae0cf6973..43b04408e 100644 --- a/docs/MANUAL.md +++ b/docs/MANUAL.md @@ -243,10 +243,10 @@ For other ways to do HTTP data upload, see the POST section below. ## Verbose / Debug -If curl fails where it isn't supposed to, if the servers don't let you in, if -you can't understand the responses: use the `-v` flag to get verbose +If curl fails where it is not supposed to, if the servers do not let you in, if +you cannot understand the responses: use the `-v` flag to get verbose fetching. Curl will output lots of info and what it sends and receives in -order to let the user see all client-server interaction (but it won't show you +order to let the user see all client-server interaction (but it will not show you the actual data). curl -v ftp://ftp.upload.com/ @@ -419,7 +419,7 @@ the "cookie" should be used for (by specifying `path=value`), when the cookie should expire (`expire=DATE`), for what domain to use it (`domain=NAME`) and if it should be used on secure connections only (`secure`). -If you've received a page from a server that contains a header like: +If you have received a page from a server that contains a header like: ```http Set-Cookie: sessionid=boo123; path="/foo"; @@ -494,7 +494,7 @@ From left-to-right: - Curr.Speed - the average transfer speed the last 5 seconds (the first 5 seconds of a transfer is based on less time of course.) -The `-#` option will display a totally different progress bar that doesn't +The `-#` option will display a totally different progress bar that does not need much explanation! ## Speed Limit @@ -515,8 +515,8 @@ operation must be completed in whole within 30 minutes: curl -m 1800 -Y 3000 -y 60 www.far-away-site.com Forcing curl not to transfer data faster than a given rate is also possible, -which might be useful if you're using a limited bandwidth connection and you -don't want your transfer to use all of it (sometimes referred to as +which might be useful if you are using a limited bandwidth connection and you +do not want your transfer to use all of it (sometimes referred to as "bandwidth throttle"). Make curl transfer data no faster than 10 kilobytes per second: @@ -575,7 +575,7 @@ URL by making a config file similar to: url = "http://help.with.curl.com/curlhelp.html" You can specify another config file to be read by using the `-K`/`--config` -flag. If you set config file name to `-` it'll read the config from stdin, +flag. If you set config file name to `-` it will read the config from stdin, which can be handy if you want to hide options from being visible in process tables etc: @@ -631,13 +631,13 @@ do this. The default way for curl is to issue the PASV command which causes the server to open another port and await another connection performed by the -client. This is good if the client is behind a firewall that doesn't allow +client. This is good if the client is behind a firewall that does not allow incoming connections. curl ftp.download.com -If the server, for example, is behind a firewall that doesn't allow -connections on ports other than 21 (or if it just doesn't support the `PASV` +If the server, for example, is behind a firewall that does not allow +connections on ports other than 21 (or if it just does not support the `PASV` command), the other way to do it is to use the `PORT` command and instruct the server to connect to the client on the given IP number and port (as parameters to the PORT command). @@ -811,7 +811,7 @@ with ALL_PROXY -A comma-separated list of host names that shouldn't go through any proxy is +A comma-separated list of host names that should not go through any proxy is set in (only an asterisk, `*` matches all hosts) NO_PROXY @@ -830,10 +830,10 @@ The usage of the `-x`/`--proxy` flag overrides the environment variables. Unix introduced the `.netrc` concept a long time ago. It is a way for a user to specify name and password for commonly visited FTP sites in a file so that -you don't have to type them in each time you visit those sites. You realize +you do not have to type them in each time you visit those sites. You realize this is a big security risk if someone else gets hold of your passwords, so -therefore most unix programs won't read this file unless it is only readable -by yourself (curl doesn't care though). +therefore most unix programs will not read this file unless it is only readable +by yourself (curl does not care though). Curl supports `.netrc` files if told to (using the `-n`/`--netrc` and `--netrc-optional` options). This is not restricted to just FTP, so curl can @@ -892,7 +892,7 @@ Other interesting options for it `-t` include: - `NEW_ENV=<var,val>` Sets an environment variable. NOTE: The telnet protocol does not specify any way to login with a specified -user and password so curl can't do that automatically. To do that, you need to +user and password so curl cannot do that automatically. To do that, you need to track when the login prompt is received and send the username and password accordingly. @@ -909,7 +909,7 @@ better use of the network. Note that curl cannot use persistent connections for transfers that are used in subsequence curl invokes. Try to stuff as many URLs as possible on the same -command line if they are using the same host, as that'll make the transfers +command line if they are using the same host, as that will make the transfers faster. If you use an HTTP proxy for file transfers, practically all transfers will be persistent. @@ -965,7 +965,7 @@ Available lists include: ### curl-users -Users of the command line tool. How to use it, what doesn't work, new +Users of the command line tool. How to use it, what does not work, new features, related tools, questions, news, installations, compilations, running, porting etc. |