aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2000-11-22 14:27:47 +0000
committerDaniel Stenberg <daniel@haxx.se>2000-11-22 14:27:47 +0000
commit6f4f3c79b62e60c7f45a62bae01951e07e7d1054 (patch)
treefc51395be8fcaaab5e57db7f7860aee17ac8ac1b /src
parent593df2f18a733a269aacc15cdd6c8630e8ffb65a (diff)
7.5-pre3 commit
Diffstat (limited to 'src')
-rw-r--r--src/hugehelp.c467
-rw-r--r--src/version.h2
2 files changed, 246 insertions, 223 deletions
diff --git a/src/hugehelp.c b/src/hugehelp.c
index 173ae185d..17dc5b92a 100644
--- a/src/hugehelp.c
+++ b/src/hugehelp.c
@@ -114,14 +114,19 @@ puts (
" cut off). The data is expected to be \"url-encoded\".\n"
" This will cause curl to pass the data to the server\n"
" using the content-type application/x-www-form-urlen­\n"
-" coded. Compare to -F.\n"
-"\n"
-" If you start the data with the letter @, the rest\n"
-" should be a file name to read the data from, or - if\n"
-" you want curl to read the data from stdin. The con­\n"
-" tents of the file must already be url-encoded.\n"
-"\n"
-" To post data purely binary, you should instead use the\n"
+" coded. Compare to -F. If more than one -d/--data option\n"
+" is used on the same command line, the data pieces spec­\n"
+" ified will be merged together with a separating &-let­\n"
+" ter. Thus, using '-d name=daniel -d skill=lousy' would\n"
+" generate a post chunk that looks like\n"
+"\n"
+" If you start the data with the letter @, the rest\n"
+" should be a file name to read the data from, or - if\n"
+" you want curl to read the data from stdin. The con­\n"
+" tents of the file must already be url-encoded. Multiple\n"
+" files can also be specified.\n"
+"\n"
+" To post data purely binary, you should instead use the\n"
" --data-binary option.\n"
"\n"
" -d/--data is the same as --data-ascii.\n"
@@ -130,62 +135,67 @@ puts (
" (HTTP) This is an alias for the -d/--data option.\n"
"\n"
" --data-binary <data>\n"
-" (HTTP) This posts data in a similar manner as --data-\n"
-" ascii does, although when using this option the entire\n"
-" context of the posted data is kept as-is. If you want\n"
-" to post a binary file without the strip-newlines fea­\n"
+" (HTTP) This posts data in a similar manner as --data-\n"
+" ascii does, although when using this option the entire\n"
+" context of the posted data is kept as-is. If you want\n"
+" to post a binary file without the strip-newlines fea­\n"
" ture of the --data-ascii option, this is for you.\n"
"\n"
" -D/--dump-header <file>\n"
-" (HTTP/FTP) Write the HTTP headers to this file. Write\n"
+" (HTTP/FTP) Write the HTTP headers to this file. Write\n"
" the FTP file info to this file if -I/--head is used.\n"
"\n"
-" This option is handy to use when you want to store the\n"
-" cookies that a HTTP site sends to you. The cookies\n"
+" This option is handy to use when you want to store the\n"
+" cookies that a HTTP site sends to you. The cookies\n"
" could then be read in a second curl invoke by using the\n"
" -b/--cookie option!\n"
"\n"
" -e/--referer <URL>\n"
" (HTTP) Sends the \"Referer Page\" information to the HTTP\n"
-" server. This can also be set with the -H/--header flag\n"
+" server. This can also be set with the -H/--header flag\n"
" of course. When used with -L/--location you can append\n"
-" \";auto\" to the referer URL to make curl automatically\n"
-" set the previous URL when it follows a Location:\n"
-" header. The \";auto\" string can be used alone, even if\n"
+" \";auto\" to the referer URL to make curl automatically\n"
+" set the previous URL when it follows a Location:\n"
+" header. The \";auto\" string can be used alone, even if\n"
" you don't set an initial referer.\n"
"\n"
" -E/--cert <certificate[:password]>\n"
-" (HTTPS) Tells curl to use the specified certificate\n"
-" file when getting a file with HTTPS. The certificate\n"
-" must be in PEM format. If the optional password isn't\n"
+" (HTTPS) Tells curl to use the specified certificate\n"
+" file when getting a file with HTTPS. The certificate\n"
+" must be in PEM format. If the optional password isn't\n"
" specified, it will be queried for on the terminal. Note\n"
-" that this certificate is the private key and the pri­\n"
+" that this certificate is the private key and the pri­\n"
" vate certificate concatenated!\n"
"\n"
+" --cacert <CA certificate>\n"
+" (HTTPS) Tells curl to use the specified certificate\n"
+" file to verify the peer. The certificate must be in PEM\n"
+" format.\n"
+"\n"
" -f/--fail\n"
-" (HTTP) Fail silently (no output at all) on server\n"
-" errors. This is mostly done like this to better enable\n"
-" scripts etc to better deal with failed attempts. In\n"
+" (HTTP) Fail silently (no output at all) on server\n"
+" errors. This is mostly done like this to better enable\n"
+" scripts etc to better deal with failed attempts. In\n"
" normal cases when a HTTP server fails to deliver a doc­\n"
-" ument, it returns a HTML document stating so (which\n"
+" ument, it returns a HTML document stating so (which\n"
" often also describes why and more). This flag will pre­\n"
-" vent curl from outputting that and fail silently\n"
+" vent curl from outputting that and fail silently\n"
" instead.\n"
"\n"
" -F/--form <name=content>\n"
" (HTTP) This lets curl emulate a filled in form in which\n"
-" a user has pressed the submit button. This causes curl\n"
+" a user has pressed the submit button. This causes curl\n"
" to POST data using the content-type multipart/form-data\n"
-" according to RFC1867. This enables uploading of binary\n"
+" according to RFC1867. This enables uploading of binary\n"
" files etc. To force the 'content' part to be be a file,\n"
-" prefix the file name with an @ sign. To just get the\n"
+" prefix the file name with an @ sign. To just get the\n"
" content part from a file, prefix the file name with the\n"
" letter <. The difference between @ and < is then that @\n"
" makes a file get attached in the post as a file upload,\n"
-" while the < makes a text field and just get the con­\n"
+" while the < makes a text field and just get the con­\n"
" tents for that text field from a file.\n"
"\n"
-" Example, to send your password file to the server,\n"
+" Example, to send your password file to the server,\n"
" where input:\n"
"\n"
" curl -F password=@/etc/passwd www.mypasswords.com\n"
@@ -199,110 +209,111 @@ puts (
"\n"
" -H/--header <header>\n"
" (HTTP) Extra header to use when getting a web page. You\n"
-" may specify any number of extra headers. Note that if\n"
-" you should add a custom header that has the same name\n"
+" may specify any number of extra headers. Note that if\n"
+" you should add a custom header that has the same name\n"
" as one of the internal ones curl would use, your exter­\n"
-" nally set header will be used instead of the internal\n"
-" one. This allows you to make even trickier stuff than\n"
-" curl would normally do. You should not replace inter­\n"
-" nally set headers without knowing perfectly well what\n"
-" you're doing. Replacing an internal header with one\n"
-" without content on the right side of the colon will\n"
+" nally set header will be used instead of the internal\n"
+" one. This allows you to make even trickier stuff than\n"
+" curl would normally do. You should not replace\n"
+" internally set headers without knowing perfectly well\n"
+" what you're doing. Replacing an internal header with\n"
+" one without content on the right side of the colon will\n"
" prevent that header from appearing.\n"
"\n"
" -i/--include\n"
" (HTTP) Include the HTTP-header in the output. The HTTP-\n"
-" header includes things like server-name, date of the\n"
+" header includes things like server-name, date of the\n"
" document, HTTP-version and more...\n"
+"\n"
" --interface <name>\n"
-" Perform an operation using a specified interface. You\n"
-" can enter interface name, IP address or host name. An\n"
+" Perform an operation using a specified interface. You\n"
+" can enter interface name, IP address or host name. An\n"
" example could look like:\n"
"\n"
" curl --interface eth0:1 http://www.netscape.com/\n"
+);
+ puts(
"\n"
" -I/--head\n"
-" (HTTP/FTP) Fetch the HTTP-header only! HTTP-servers\n"
+" (HTTP/FTP) Fetch the HTTP-header only! HTTP-servers\n"
" feature the command HEAD which this uses to get nothing\n"
-" but the header of a document. When used on a FTP file,\n"
+" but the header of a document. When used on a FTP file,\n"
" curl displays the file size only.\n"
"\n"
" --krb4 <level>\n"
-" (FTP) Enable kerberos4 authentication and use. The\n"
-);
- puts(
-" level must be entered and should be one of 'clear',\n"
-" 'safe', 'confidential' or 'private'. Should you use a\n"
-" level that is not one of these, 'private' will instead\n"
+" (FTP) Enable kerberos4 authentication and use. The\n"
+" level must be entered and should be one of 'clear',\n"
+" 'safe', 'confidential' or 'private'. Should you use a\n"
+" level that is not one of these, 'private' will instead\n"
" be used.\n"
"\n"
" -K/--config <config file>\n"
-" Specify which config file to read curl arguments from.\n"
-" The config file is a text file in which command line\n"
-" arguments can be written which then will be used as if\n"
-" they were written on the actual command line. If the\n"
-" first column of a config line is a '#' character, the\n"
+" Specify which config file to read curl arguments from.\n"
+" The config file is a text file in which command line\n"
+" arguments can be written which then will be used as if\n"
+" they were written on the actual command line. If the\n"
+" first column of a config line is a '#' character, the\n"
" rest of the line will be treated as a comment.\n"
"\n"
-" Specify the filename as '-' to make curl read the file\n"
+" Specify the filename as '-' to make curl read the file\n"
" from stdin.\n"
"\n"
" -l/--list-only\n"
" (FTP) When listing an FTP directory, this switch forces\n"
-" a name-only view. Especially useful if you want to\n"
-" machine-parse the contents of an FTP directory since\n"
-" the normal directory view doesn't use a standard look\n"
+" a name-only view. Especially useful if you want to\n"
+" machine-parse the contents of an FTP directory since\n"
+" the normal directory view doesn't use a standard look\n"
" or format.\n"
"\n"
" -L/--location\n"
-" (HTTP/HTTPS) If the server reports that the requested\n"
-" page has a different location (indicated with the\n"
-" header line Location:) this flag will let curl attempt\n"
+" (HTTP/HTTPS) If the server reports that the requested\n"
+" page has a different location (indicated with the\n"
+" header line Location:) this flag will let curl attempt\n"
" to reattempt the get on the new place. If used together\n"
" with -i or -I, headers from all requested pages will be\n"
-" shown. If this flag is used when making a HTTP POST,\n"
+" shown. If this flag is used when making a HTTP POST,\n"
" curl will automatically switch to GET after the initial\n"
" POST has been done.\n"
"\n"
" -m/--max-time <seconds>\n"
" Maximum time in seconds that you allow the whole opera­\n"
" tion to take. This is useful for preventing your batch\n"
-" jobs from hanging for hours due to slow networks or\n"
-" links going down. This doesn't work fully in win32\n"
+" jobs from hanging for hours due to slow networks or\n"
+" links going down. This doesn't work fully in win32\n"
" systems.\n"
"\n"
" -M/--manual\n"
" Manual. Display the huge help text.\n"
"\n"
" -n/--netrc\n"
-" Makes curl scan the .netrc file in the user's home\n"
-" directory for login name and password. This is typi­\n"
-" cally used for ftp on unix. If used with http, curl\n"
-" will enable user authentication. See netrc(4) for\n"
-" details on the file format. Curl will not complain if\n"
-" that file hasn't the right permissions (it should not\n"
-" be world nor group readable). The environment variable\n"
+" Makes curl scan the .netrc file in the user's home\n"
+" directory for login name and password. This is typi­\n"
+" cally used for ftp on unix. If used with http, curl\n"
+" will enable user authentication. See netrc(4) for\n"
+" details on the file format. Curl will not complain if\n"
+" that file hasn't the right permissions (it should not\n"
+" be world nor group readable). The environment variable\n"
" \"HOME\" is used to find the home directory.\n"
"\n"
-" A quick and very simple example of how to setup a\n"
-" .netrc to allow curl to ftp to the machine\n"
+" A quick and very simple example of how to setup a\n"
+" .netrc to allow curl to ftp to the machine\n"
" host.domain.com with user name\n"
"\n"
" machine host.domain.com login myself password secret\n"
"\n"
" -N/--no-buffer\n"
-" Disables the buffering of the output stream. In normal\n"
+" Disables the buffering of the output stream. In normal\n"
" work situations, curl will use a standard buffered out­\n"
-" put stream that will have the effect that it will out­\n"
-" put the data in chunks, not necessarily exactly when\n"
-" the data arrives. Using this option will disable that\n"
+" put stream that will have the effect that it will out­\n"
+" put the data in chunks, not necessarily exactly when\n"
+" the data arrives. Using this option will disable that\n"
" buffering.\n"
"\n"
" -o/--output <file>\n"
-" Write output to <file> instead of stdout. If you are\n"
+" Write output to <file> instead of stdout. If you are\n"
" using {} or [] to fetch multiple documents, you can use\n"
-" '#' followed by a number in the <file> specifier. That\n"
-" variable will be replaced with the current string for\n"
+" '#' followed by a number in the <file> specifier. That\n"
+" variable will be replaced with the current string for\n"
" the URL being fetched. Like in:\n"
"\n"
" curl http://{one,two}.site.com -o \"file_#1.txt\"\n"
@@ -310,7 +321,6 @@ puts (
" or use several variables like:\n"
"\n"
" curl http://{site,host}.host[1-5].com -o \"#1_#2\"\n"
-"\n"
" -O/--remote-name\n"
" Write output to a local file named like the remote file\n"
" we get. (Only the file part of the remote file is used,\n"
@@ -318,22 +328,22 @@ puts (
"\n"
" -p/--proxytunnel\n"
" When an HTTP proxy is used, this option will cause non-\n"
-" HTTP protocols to attempt to tunnel through the proxy\n"
-" instead of merely using it to do HTTP-like operations.\n"
+" HTTP protocols to attempt to tunnel through the proxy\n"
+" instead of merely using it to do HTTP-like operations.\n"
" The tunnel approach is made with the HTTP proxy CONNECT\n"
-" request and requires that the proxy allows direct con­\n"
-" nect to the remote port number curl wants to tunnel\n"
+" request and requires that the proxy allows direct con­\n"
+" nect to the remote port number curl wants to tunnel\n"
" through to.\n"
"\n"
" -P/--ftpport <address>\n"
-" (FTP) Reverses the initiator/listener roles when con­\n"
-" necting with ftp. This switch makes Curl use the PORT\n"
-" command instead of PASV. In practice, PORT tells the\n"
+" (FTP) Reverses the initiator/listener roles when con­\n"
+" necting with ftp. This switch makes Curl use the PORT\n"
+" command instead of PASV. In practice, PORT tells the\n"
" server to connect to the client's specified address and\n"
-" port, while PASV asks the server for an ip address and\n"
+" port, while PASV asks the server for an ip address and\n"
" port to connect to. <address> should be one of:\n"
"\n"
-" interface i.e \"eth0\" to specify which interface's IP\n"
+" interface i.e \"eth0\" to specify which interface's IP\n"
" address you want to use (Unix only)\n"
"\n"
" IP address i.e \"192.168.10.1\" to specify exact IP num­\n"
@@ -341,28 +351,28 @@ puts (
"\n"
" host name i.e \"my.host.domain\" to specify machine\n"
"\n"
-" - (any single-letter string) to make it pick\n"
+" - (any single-letter string) to make it pick\n"
" the machine's default\n"
"\n"
" -q If used as the first parameter on the command line, the\n"
-" $HOME/.curlrc file will not be read and used as a con­\n"
+" $HOME/.curlrc file will not be read and used as a con­\n"
" fig file.\n"
"\n"
" -Q/--quote <comand>\n"
-" (FTP) Send an arbitrary command to the remote FTP\n"
-" server, by using the QUOTE command of the server. Not\n"
-" all servers support this command, and the set of QUOTE\n"
-" commands are server specific! Quote commands are sent\n"
-" BEFORE the transfer is taking place. To make commands\n"
-" take place after a successful transfer, prefix them\n"
+" (FTP) Send an arbitrary command to the remote FTP\n"
+" server, by using the QUOTE command of the server. Not\n"
+" all servers support this command, and the set of QUOTE\n"
+" commands are server specific! Quote commands are sent\n"
+" BEFORE the transfer is taking place. To make commands\n"
+" take place after a successful transfer, prefix them\n"
" with a dash '-'. You may specify any amount of commands\n"
-" to be run before and after the transfer. If the server\n"
-" returns failure for one of the commands, the entire\n"
+" to be run before and after the transfer. If the server\n"
+" returns failure for one of the commands, the entire\n"
" operation will be aborted.\n"
"\n"
" -r/--range <range>\n"
-" (HTTP/FTP) Retrieve a byte range (i.e a partial docu­\n"
-" ment) from a HTTP/1.1 or FTP server. Ranges can be\n"
+" (HTTP/FTP) Retrieve a byte range (i.e a partial docu­\n"
+" ment) from a HTTP/1.1 or FTP server. Ranges can be\n"
" specified in a number of ways.\n"
"\n"
" 0-499 specifies the first 500 bytes\n"
@@ -371,8 +381,8 @@ puts (
"\n"
" -500 specifies the last 500 bytes\n"
"\n"
-" 9500 specifies the bytes from offset 9500 and\n"
-" forward\n"
+" 9500 specifies the bytes from offset 9500 and for­\n"
+" ward\n"
"\n"
" 0-0,-1 specifies the first and last byte only(*)(H)\n"
"\n"
@@ -382,167 +392,173 @@ puts (
" 100-199,500-599\n"
" specifies two separate 100 bytes ranges(*)(H)\n"
"\n"
-" (*) = NOTE that this will cause the server to reply with a\n"
+" (*) = NOTE that this will cause the server to reply with a\n"
" multipart response!\n"
"\n"
-" You should also be aware that many HTTP/1.1 servers do not\n"
+" You should also be aware that many HTTP/1.1 servers do not\n"
" have this feature enabled, so that when you attempt to get a\n"
" range, you'll instead get the whole document.\n"
"\n"
-" FTP range downloads only support the simple syntax 'start-\n"
-" stop' (optionally with one of the numbers omitted). It\n"
+" FTP range downloads only support the simple syntax 'start-\n"
+" stop' (optionally with one of the numbers omitted). It\n"
" depends on the non-RFC command SIZE.\n"
"\n"
" -s/--silent\n"
-" Silent mode. Don't show progress meter or error mes­\n"
+" Silent mode. Don't show progress meter or error mes­\n"
" sages. Makes Curl mute.\n"
"\n"
" -S/--show-error\n"
-" When used with -s it makes curl show error message if\n"
+" When used with -s it makes curl show error message if\n"
" it fails.\n"
"\n"
" -t/--upload\n"
-" Deprecated. Use '-T -' instead. Transfer the stdin\n"
-" data to the specified file. Curl will read everything\n"
-" from stdin until EOF and store with the supplied name.\n"
-" If this is used on a http(s) server, the PUT command\n"
+" Deprecated. Use '-T -' instead. Transfer the stdin\n"
+" data to the specified file. Curl will read everything\n"
+" from stdin until EOF and store with the supplied name.\n"
+" If this is used on a http(s) server, the PUT command\n"
" will be used.\n"
"\n"
" -T/--upload-file <file>\n"
-" Like -t, but this transfers the specified local file.\n"
-" If there is no file part in the specified URL, Curl\n"
+" Like -t, but this transfers the specified local file.\n"
+" If there is no file part in the specified URL, Curl\n"
" will append the local file name. NOTE that you must use\n"
-" a trailing / on the last directory to really prove to\n"
+" a trailing / on the last directory to really prove to\n"
" Curl that there is no file name or curl will think that\n"
-" your last directory name is the remote file name to\n"
-" use. That will most likely cause the upload operation\n"
-" to fail. If this is used on a http(s) server, the PUT\n"
+" your last directory name is the remote file name to\n"
+" use. That will most likely cause the upload operation\n"
+" to fail. If this is used on a http(s) server, the PUT\n"
" command will be used.\n"
"\n"
" -u/--user <user:password>\n"
-" Specify user and password to use when fetching. See\n"
-" README.curl for detailed examples of how to use this.\n"
-" If no password is specified, curl will ask for it\n"
+" Specify user and password to use when fetching. See\n"
+" README.curl for detailed examples of how to use this.\n"
+" If no password is specified, curl will ask for it\n"
" interactively.\n"
+"\n"
" -U/--proxy-user <user:password>\n"
-" Specify user and password to use for Proxy authentica­\n"
+" Specify user and password to use for Proxy authentica­\n"
" tion. If no password is specified, curl will ask for it\n"
" interactively.\n"
"\n"
+" --url <URL>\n"
+" Set the URL to fetch. This option is mostly handy when\n"
+" you wanna specify URL in a config file.\n"
+"\n"
" -v/--verbose\n"
-" Makes the fetching more verbose/talkative. Mostly\n"
-" usable for debugging. Lines starting with '>' means\n"
+" Makes the fetching more verbose/talkative. Mostly\n"
+" usable for debugging. Lines starting with '>' means\n"
" data sent by curl, '<' means data received by curl that\n"
-" is hidden in normal cases and lines starting with '*'\n"
+" is hidden in normal cases and lines starting with '*'\n"
" means additional info provided by curl.\n"
"\n"
" -V/--version\n"
-" Displays the full version of curl, libcurl and other\n"
+" Displays the full version of curl, libcurl and other\n"
" 3rd party libraries linked with the executable.\n"
"\n"
" -w/--write-out <format>\n"
-" Defines what to display after a completed and success­\n"
-" ful operation. The format is a string that may contain\n"
-" plain text mixed with any number of variables. The\n"
+" Defines what to display after a completed and success­\n"
+" ful operation. The format is a string that may contain\n"
+" plain text mixed with any number of variables. The\n"
" string can be specified as \"string\", to get read from a\n"
-" particular file you specify it \"@filename\" and to tell\n"
+" particular file you specify it \"@filename\" and to tell\n"
" curl to read the format from stdin you write \"@-\".\n"
"\n"
" The variables present in the output format will be sub­\n"
-" stituted by the value or text that curl thinks fit, as\n"
-" described below. All variables are specified like\n"
-" %{variable_name} and to output a normal % you just\n"
-" write them like %%. You can output a newline by using\n"
+" stituted by the value or text that curl thinks fit, as\n"
+" described below. All variables are specified like\n"
+" %{variable_name} and to output a normal % you just\n"
+" write them like %%. You can output a newline by using\n"
" \\n, a carrige return with \\r and a tab space with \\t.\n"
"\n"
-" NOTE: The %-letter is a special letter in the\n"
-" win32-environment, where all occurrences of % must be\n"
+" NOTE: The %-letter is a special letter in the\n"
+" win32-environment, where all occurrences of % must be\n"
" doubled when using this option.\n"
"\n"
" Available variables are at this point:\n"
+);
+ puts(
"\n"
-" url_effective The URL that was fetched last. This is\n"
+" url_effective The URL that was fetched last. This is\n"
" mostly meaningful if you've told curl to\n"
" follow location: headers.\n"
"\n"
" http_code The numerical code that was found in the\n"
-);
- puts(
" last retrieved HTTP(S) page.\n"
"\n"
-" time_total The total time, in seconds, that the\n"
-" full operation lasted. The time will be\n"
+" time_total The total time, in seconds, that the\n"
+" full operation lasted. The time will be\n"
" displayed with millisecond resolution.\n"
"\n"
" time_namelookup\n"
-" The time, in seconds, it took from the\n"
-" start until the name resolving was com­\n"
+" The time, in seconds, it took from the\n"
+" start until the name resolving was com­\n"
" pleted.\n"
-" time_connect The time, in seconds, it took from the\n"
-" start until the connect to the remote\n"
+"\n"
+" time_connect The time, in seconds, it took from the\n"
+" start until the connect to the remote\n"
" host (or proxy) was completed.\n"
"\n"
" time_pretransfer\n"
-" The time, in seconds, it took from the\n"
-" start until the file transfer is just\n"
-" about to begin. This includes all pre-\n"
-" transfer commands and negotiations that\n"
-" are specific to the particular proto­\n"
+" The time, in seconds, it took from the\n"
+" start until the file transfer is just\n"
+" about to begin. This includes all pre-\n"
+" transfer commands and negotiations that\n"
+" are specific to the particular proto­\n"
" col(s) involved.\n"
"\n"
-" size_download The total amount of bytes that were\n"
+" size_download The total amount of bytes that were\n"
" downloaded.\n"
"\n"
-" size_upload The total amount of bytes that were\n"
+" size_upload The total amount of bytes that were\n"
" uploaded.\n"
"\n"
-" size_header The total amount of bytes of the down­\n"
+" size_header The total amount of bytes of the down­\n"
" loaded headers.\n"
"\n"
" size_request The total amount of bytes that were sent\n"
" in the HTTP request.\n"
"\n"
-" speed_download The average download speed that curl\n"
+" speed_download The average download speed that curl\n"
" measured for the complete download.\n"
"\n"
-" speed_upload The average upload speed that curl mea­\n"
+" speed_upload The average upload speed that curl mea­\n"
" sured for the complete upload.\n"
"\n"
" -x/--proxy <proxyhost[:port]>\n"
-" Use specified proxy. If the port number is not speci­\n"
+" Use specified proxy. If the port number is not speci­\n"
" fied, it is assumed at port 1080.\n"
"\n"
" -X/--request <command>\n"
-" (HTTP) Specifies a custom request to use when communi­\n"
-" cating with the HTTP server. The specified request\n"
+" (HTTP) Specifies a custom request to use when communi­\n"
+" cating with the HTTP server. The specified request\n"
" will be used instead of the standard GET. Read the HTTP\n"
" 1.1 specification for details and explanations.\n"
"\n"
-" (FTP) Specifies a custom FTP command to use instead of\n"
+" (FTP) Specifies a custom FTP command to use instead of\n"
" LIST when doing file lists with ftp.\n"
"\n"
" -y/--speed-time <time>\n"
" If a download is slower than speed-limit bytes per sec­\n"
-" ond during a speed-time period, the download gets\n"
+" ond during a speed-time period, the download gets\n"
" aborted. If speed-time is used, the default speed-limit\n"
" will be 1 unless set with -y.\n"
"\n"
" -Y/--speed-limit <speed>\n"
" If a download is slower than this given speed, in bytes\n"
-" per second, for speed-time seconds it gets aborted.\n"
+" per second, for speed-time seconds it gets aborted.\n"
" speed-time is set with -Y and is 30 if not set.\n"
"\n"
" -z/--time-cond <date expression>\n"
-" (HTTP) Request to get a file that has been modified\n"
-" later than the given time and date, or one that has\n"
+" (HTTP) Request to get a file that has been modified\n"
+" later than the given time and date, or one that has\n"
" been modified before that time. The date expression can\n"
" be all sorts of date strings or if it doesn't match any\n"
-" internal ones, it tries to get the time from a given\n"
-" file name instead! See the GNU date(1) or curl_get­\n"
+" internal ones, it tries to get the time from a given\n"
+" file name instead! See the GNU date(1) or curl_get­\n"
" date(3) man pages for date expression details.\n"
"\n"
-" Start the date expression with a dash (-) to make it\n"
-" request for a document that is older than the given\n"
+" Start the date expression with a dash (-) to make it\n"
+" request for a document that is older than the given\n"
" date/time, default is a document that is newer than the\n"
" specified date/time.\n"
"\n"
@@ -555,19 +571,18 @@ puts (
" ing with a remote SSL server.\n"
"\n"
" -#/--progress-bar\n"
-" Make curl display progress information as a progress\n"
+" Make curl display progress information as a progress\n"
" bar instead of the default statistics.\n"
"\n"
" --crlf\n"
-" (FTP) Convert LF to CRLF in upload. Useful for MVS\n"
+" (FTP) Convert LF to CRLF in upload. Useful for MVS\n"
" (OS/390).\n"
"\n"
" --stderr <file>\n"
-" Redirect all writes to stderr to the specified file\n"
+" Redirect all writes to stderr to the specified file\n"
" instead. If the file name is a plain '-', it is instead\n"
" written to stdout. This option has no point when you're\n"
" using a shell with decent redirecting capabilities.\n"
-"\n"
"FILES\n"
" ~/.curlrc\n"
" Default config file.\n"
@@ -581,11 +596,12 @@ puts (
"\n"
" FTP_PROXY [protocol://]<host>[:port]\n"
" Sets proxy server to use for FTP.\n"
+"\n"
" GOPHER_PROXY [protocol://]<host>[:port]\n"
" Sets proxy server to use for GOPHER.\n"
"\n"
" ALL_PROXY [protocol://]<host>[:port]\n"
-" Sets proxy server to use if no protocol-specific proxy\n"
+" Sets proxy server to use if no protocol-specific proxy\n"
" is set.\n"
"\n"
" NO_PROXY <comma-separated list of hosts>\n"
@@ -593,12 +609,12 @@ puts (
" If set to a asterisk '*' only, it matches all hosts.\n"
"\n"
" COLUMNS <integer>\n"
-" The width of the terminal. This variable only affects\n"
+" The width of the terminal. This variable only affects\n"
" curl when the --progress-bar option is used.\n"
"\n"
"EXIT CODES\n"
" There exists a bunch of different error codes and their cor­\n"
-" responding error messages that may appear during bad condi­\n"
+" responding error messages that may appear during bad condi­\n"
" tions. At the time of this writing, the exit codes are:\n"
"\n"
" 1 Unsupported protocol. This build of curl has no support\n"
@@ -608,95 +624,94 @@ puts (
"\n"
" 3 URL malformat. The syntax was not correct.\n"
"\n"
-" 4 URL user malformatted. The user-part of the URL syntax\n"
+" 4 URL user malformatted. The user-part of the URL syntax\n"
" was not correct.\n"
"\n"
-" 5 Couldn't resolve proxy. The given proxy host could not\n"
+" 5 Couldn't resolve proxy. The given proxy host could not\n"
" be resolved.\n"
"\n"
-" 6 Couldn't resolve host. The given remote host was not\n"
+" 6 Couldn't resolve host. The given remote host was not\n"
" resolved.\n"
"\n"
" 7 Failed to connect to host.\n"
-"\n"
-" 8 FTP weird server reply. The server sent data curl\n"
+" 8 FTP weird server reply. The server sent data curl\n"
" couldn't parse.\n"
"\n"
" 9 FTP access denied. The server denied login.\n"
"\n"
-" 10 FTP user/password incorrect. Either one or both were\n"
+" 10 FTP user/password incorrect. Either one or both were\n"
" not accepted by the server.\n"
"\n"
-" 11 FTP weird PASS reply. Curl couldn't parse the reply\n"
+" 11 FTP weird PASS reply. Curl couldn't parse the reply\n"
" sent to the PASS request.\n"
"\n"
-" 12 FTP weird USER reply. Curl couldn't parse the reply\n"
+" 12 FTP weird USER reply. Curl couldn't parse the reply\n"
" sent to the USER request.\n"
-" 13 FTP weird PASV reply, Curl couldn't parse the reply\n"
+"\n"
+" 13 FTP weird PASV reply, Curl couldn't parse the reply\n"
" sent to the PASV request.\n"
"\n"
-" 14 FTP weird 227 formay. Curl couldn't parse the 227-line\n"
+" 14 FTP weird 227 formay. Curl couldn't parse the 227-line\n"
" the server sent.\n"
"\n"
" 15 FTP can't get host. Couldn't resolve the host IP we got\n"
" in the 227-line.\n"
"\n"
-" 16 FTP can't reconnect. Couldn't connect to the host we\n"
+" 16 FTP can't reconnect. Couldn't connect to the host we\n"
" got in the 227-line.\n"
"\n"
-" 17 FTP couldn't set binary. Couldn't change transfer\n"
+" 17 FTP couldn't set binary. Couldn't change transfer\n"
" method to binary.\n"
"\n"
" 18 Partial file. Only a part of the file was transfered.\n"
"\n"
" 19 FTP couldn't RETR file. The RETR command failed.\n"
"\n"
-" 20 FTP write error. The transfer was reported bad by the\n"
+" 20 FTP write error. The transfer was reported bad by the\n"
" server.\n"
"\n"
-" 21 FTP quote error. A quote command returned error from\n"
+" 21 FTP quote error. A quote command returned error from\n"
" the server.\n"
"\n"
-" 22 HTTP not found. The requested page was not found. This\n"
+" 22 HTTP not found. The requested page was not found. This\n"
" return code only appears if --fail is used.\n"
"\n"
-" 23 Write error. Curl couldn't write data to a local\n"
+" 23 Write error. Curl couldn't write data to a local\n"
" filesystem or similar.\n"
"\n"
" 24 Malformat user. User name badly specified.\n"
"\n"
-" 25 FTP couldn't STOR file. The server denied the STOR\n"
+" 25 FTP couldn't STOR file. The server denied the STOR\n"
" operation.\n"
"\n"
" 26 Read error. Various reading problems.\n"
-"\n"
" 27 Out of memory. A memory allocation request failed.\n"
"\n"
-" 28 Operation timeout. The specified time-out period was\n"
+" 28 Operation timeout. The specified time-out period was\n"
" reached according to the conditions.\n"
"\n"
-" 29 FTP couldn't set ASCII. The server returned an unknown\n"
+" 29 FTP couldn't set ASCII. The server returned an unknown\n"
" reply.\n"
"\n"
" 30 FTP PORT failed. The PORT command failed.\n"
"\n"
" 31 FTP couldn't use REST. The REST command failed.\n"
"\n"
-" 32 FTP couldn't use SIZE. The SIZE command failed. The\n"
-" command is an extension to the original FTP spec RFC\n"
+" 32 FTP couldn't use SIZE. The SIZE command failed. The\n"
+" command is an extension to the original FTP spec RFC\n"
" 959.\n"
"\n"
" 33 HTTP range error. The range \"command\" didn't work.\n"
"\n"
-" 34 HTTP post error. Internal post-request generation\n"
+" 34 HTTP post error. Internal post-request generation\n"
" error.\n"
"\n"
" 35 SSL connect error. The SSL handshaking failed.\n"
"\n"
-" 36 FTP bad download resume. Couldn't continue an earlier\n"
+" 36 FTP bad download resume. Couldn't continue an earlier\n"
" aborted download.\n"
"\n"
-" 37 FILE couldn't read file. Failed to open the file. Per­\n"
+" 37 FILE couldn't read file. Failed to open the file. Per­\n"
" missions?\n"
"\n"
" 38 LDAP cannot bind. LDAP bind operation failed.\n"
@@ -705,15 +720,14 @@ puts (
"\n"
" 40 Library not found. The LDAP library was not found.\n"
"\n"
-" 41 Function not found. A required LDAP function was not\n"
+" 41 Function not found. A required LDAP function was not\n"
" found.\n"
"\n"
-" XX There will appear more error codes here in future\n"
-" releases. The existing ones are meant to never change.\n"
+" XX There will appear more error codes here in future\n"
+" releases. The existing ones are meant to never change.\n"
"\n"
"BUGS\n"
-" If you do find any (or have other suggestions), mail Daniel\n"
-" Stenberg <Daniel.Stenberg@haxx.se>.\n"
+" If you do find bugs, mail them to curl-bug@haxx.se.\n"
"\n"
"AUTHORS / CONTRIBUTORS\n"
" - Daniel Stenberg <Daniel.Stenberg@haxx.se>\n"
@@ -748,9 +762,9 @@ puts (
" - Linus Nielsen <Linus.Nielsen@haxx.se>\n"
" - Felix von Leitner <felix@convergence.de>\n"
" - Dan Zitter <dzitter@zitter.net>\n"
-" - Jongki Suwandi <Jongki.Suwandi@eng.sun.com>\n"
);
puts(
+" - Jongki Suwandi <Jongki.Suwandi@eng.sun.com>\n"
" - Chris Maltby <chris@aurema.com>\n"
" - Ron Zapp <rzapper@yahoo.com>\n"
" - Paul Marquis <pmarquis@iname.com>\n"
@@ -771,10 +785,10 @@ puts (
" - Martin Hedenfalk <mhe@stacken.kth.se>\n"
" - Richard Prescott\n"
" - Jason S. Priebe <priebe@wral-tv.com>\n"
+" - T. Bharath <TBharath@responsenetworks.com>\n"
"\n"
"WWW\n"
" http://curl.haxx.se\n"
-"\n"
"FTP\n"
" ftp://ftp.sunet.se/pub/www/utilities/curl/\n"
"\n"
@@ -1061,11 +1075,11 @@ puts (
" that referred to actual page, and curl allows the user to specify that\n"
" referrer to get specified on the command line. It is especially useful to\n"
" fool or trick stupid servers or CGI scripts that rely on that information\n"
+);
+ puts(
" being available or contain certain data.\n"
"\n"
" curl -e www.coolsite.com http://www.showme.com/\n"
-);
- puts(
"\n"
"USER AGENT\n"
"\n"
@@ -1185,17 +1199,26 @@ puts (
"CONFIG FILE\n"
"\n"
" Curl automatically tries to read the .curlrc file (or _curlrc file on win32\n"
-" systems) from the user's home dir on startup. The config file should be\n"
-" made up with normal command line switches. Comments can be used within the\n"
-" file. If the first letter on a line is a '#'-letter the rest of the line\n"
-" is treated as a comment.\n"
+" systems) from the user's home dir on startup.\n"
+"\n"
+" The config file could be made up with normal command line switches, but you\n"
+" can also specify the long options without the dashes to make it more\n"
+" readable. You can separate the options and the parameter with spaces, or\n"
+" with = or :. Comments can be used within the file. If the first letter on a\n"
+" line is a '#'-letter the rest of the line is treated as a comment.\n"
+"\n"
+" If you want the parameter to contain spaces, you must inclose the entire\n"
+" parameter within double quotes (\"). Within those quotes, you specify a\n"
+" quote as \\\".\n"
+"\n"
+" NOTE: You must specify options and their arguments on the same line.\n"
"\n"
" Example, set default time out and proxy in a config file:\n"
"\n"
" # We want a 30 minute timeout:\n"
" -m 1800\n"
" # ... and we use a proxy for all accesses:\n"
-" -x proxy.our.domain.com:8080\n"
+" proxy = proxy.our.domain.com:8080\n"
"\n"
" White spaces ARE significant at the end of lines, but all white spaces\n"
" leading up to the first characters of each line are ignored.\n"
@@ -1209,14 +1232,14 @@ puts (
" without URL by making a config file similar to:\n"
"\n"
" # default url to get\n"
-" http://help.with.curl.com/curlhelp.html\n"
+" url = \"http://help.with.curl.com/curlhelp.html\"\n"
"\n"
" You can specify another config file to be read by using the -K/--config\n"
" flag. If you set config file name to \"-\" it'll read the config from stdin,\n"
" which can be handy if you want to hide options from being visible in process\n"
" tables etc:\n"
"\n"
-" echo \"-u user:passwd\" | curl -K - http://that.secret.site.com\n"
+" echo \"user = user:passwd\" | curl -K - http://that.secret.site.com\n"
"\n"
"EXTRA HEADERS\n"
"\n"
@@ -1313,6 +1336,8 @@ puts (
" included in recent versions of OpenSSL, and for older versions Dr Stephen\n"
" N. Henson has written a patch for SSLeay that adds this functionality. You\n"
" can get his patch (that requires an SSLeay installation) from his site at:\n"
+);
+ puts(
" http://www.drh-consultancy.demon.co.uk/\n"
"\n"
" Example on how to automatically retrieve a document using a certificate with\n"
@@ -1325,8 +1350,6 @@ puts (
"\n"
" Many older SSL-servers have problems with SSLv3 or TLS, that newer versions\n"
" of OpenSSL etc is using, therefore it is sometimes useful to specify what\n"
-);
- puts(
" SSL-version curl should use. Use -3 or -2 to specify that exact SSL version\n"
" to use:\n"
"\n"
diff --git a/src/version.h b/src/version.h
index 9172ce237..8a984dc12 100644
--- a/src/version.h
+++ b/src/version.h
@@ -1,3 +1,3 @@
#define CURL_NAME "curl"
-#define CURL_VERSION "7.4.1"
+#define CURL_VERSION "7.5-pre3"
#define CURL_ID CURL_NAME " " CURL_VERSION " (" OS ") "