aboutsummaryrefslogtreecommitdiff
path: root/src/hugehelp.c
diff options
context:
space:
mode:
Diffstat (limited to 'src/hugehelp.c')
-rw-r--r--src/hugehelp.c214
1 files changed, 175 insertions, 39 deletions
diff --git a/src/hugehelp.c b/src/hugehelp.c
index e8f1b5a4a..d43a2e2a8 100644
--- a/src/hugehelp.c
+++ b/src/hugehelp.c
@@ -53,12 +53,19 @@ puts (
" append to the target file instead of overwriting it. If\n"
" the file doesn't exist, it will be created.\n"
"\n"
+" If this option is used twice, the second one will dis­\n"
+" able append mode again.\n"
+"\n"
" -A/--user-agent <agent string>\n"
-" (HTTP) Specify the User-Agent string to send to the\n"
-" HTTP server. Some badly done CGIs fail if its not set\n"
-" to \"Mozilla/4.0\". To encode blanks in the string, sur­\n"
-" round the string with single quote marks. This can\n"
+" (HTTP) Specify the User-Agent string to send to the\n"
+" HTTP server. Some badly done CGIs fail if its not set\n"
+" to \"Mozilla/4.0\". To encode blanks in the string,\n"
+" surround the string with single quote marks. This can\n"
" also be set with the -H/--header flag of course.\n"
+"\n"
+" If this option is used more than once, the last one\n"
+" will be the one to be used.\n"
+"\n"
" -b/--cookie <name=data>\n"
" (HTTP) Pass the data to the HTTP server as a cookie. It\n"
" is supposedly the data previously received from the\n"
@@ -80,12 +87,18 @@ puts (
" To store cookies, save the HTTP headers to a file using\n"
" -D/--dump-header!\n"
"\n"
+" If this option is used more than once, the last one\n"
+" will be the one to be used.\n"
+"\n"
" -B/--use-ascii\n"
-" Use ASCII transfer when getting an FTP file or LDAP\n"
-" info. For FTP, this can also be enforced by using an\n"
-" URL that ends with \";type=A\". This option causes data\n"
+" Use ASCII transfer when getting an FTP file or LDAP\n"
+" info. For FTP, this can also be enforced by using an\n"
+" URL that ends with \";type=A\". This option causes data\n"
" sent to stdout to be in text mode for win32 systems.\n"
"\n"
+" If this option is used twice, the second one will dis­\n"
+" able ASCII usage.\n"
+"\n"
" -c/--continue\n"
" Deprecated. Use '-C -' instead. Continue/Resume a pre­\n"
" vious file transfer. This instructs curl to continue\n"
@@ -107,17 +120,20 @@ puts (
" HTTP resume is only possible with HTTP/1.1 or later\n"
" servers.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
+"\n"
" -d/--data <data>\n"
-" (HTTP) Sends the specified data in a POST request to\n"
-" the HTTP server. Note that the data is sent exactly as\n"
-" specified with no extra processing (with all newlines\n"
-" cut off). The data is expected to be \"url-encoded\".\n"
-" This will cause curl to pass the data to the server\n"
+" (HTTP) Sends the specified data in a POST request to\n"
+" the HTTP server. Note that the data is sent exactly as\n"
+" specified with no extra processing (with all newlines\n"
+" 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. 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"
+" 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"
@@ -131,9 +147,15 @@ puts (
"\n"
" -d/--data is the same as --data-ascii.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
+"\n"
" --data-ascii <data>\n"
" (HTTP) This is an alias for the -d/--data option.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
@@ -141,6 +163,9 @@ puts (
" to post a binary file without the strip-newlines fea­\n"
" ture of the --data-ascii option, this is for you.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
+"\n"
" -D/--dump-header <file>\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"
@@ -150,6 +175,9 @@ puts (
" could then be read in a second curl invoke by using the\n"
" -b/--cookie option!\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
@@ -159,6 +187,9 @@ puts (
" header. The \";auto\" string can be used alone, even if\n"
" you don't set an initial referer.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
@@ -167,21 +198,30 @@ puts (
" that this certificate is the private key and the pri­\n"
" vate certificate concatenated!\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
" normal cases when a HTTP server fails to deliver a doc­\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"
+" often also describes why and more). This flag will\n"
+" prevent curl from outputting that and fail silently\n"
" instead.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable silent failure.\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"
@@ -202,8 +242,12 @@ puts (
"\n"
" To read the file's content from stdin insted of a file,\n"
" use - where the file name should've been. This goes for\n"
+);
+ puts(
" both @ and < constructs.\n"
"\n"
+" This option can be used multiple times.\n"
+"\n"
" -h/--help\n"
" Usage help.\n"
"\n"
@@ -214,16 +258,20 @@ puts (
" 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\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"
+" 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"
" prevent that header from appearing.\n"
"\n"
+" This option can be used multiple times.\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"
" document, HTTP-version and more...\n"
+" If this option is used twice, the second will again\n"
+" disable header include.\n"
"\n"
" --interface <name>\n"
" Perform an operation using a specified interface. You\n"
@@ -231,8 +279,9 @@ puts (
" example could look like:\n"
"\n"
" curl --interface eth0:1 http://www.netscape.com/\n"
-);
- puts(
+"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
"\n"
" -I/--head\n"
" (HTTP/FTP) Fetch the HTTP-header only! HTTP-servers\n"
@@ -240,6 +289,9 @@ puts (
" but the header of a document. When used on a FTP file,\n"
" curl displays the file size only.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable header only.\n"
+"\n"
" --krb4 <level>\n"
" (FTP) Enable kerberos4 authentication and use. The\n"
" level must be entered and should be one of 'clear',\n"
@@ -247,17 +299,25 @@ puts (
" level that is not one of these, 'private' will instead\n"
" be used.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will 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"
-" rest of the line will be treated as a comment.\n"
+" they were written on the actual command line. Options\n"
+" and their parameters must be specified on the same con­\n"
+" fig file line. If the parameter is to contain white\n"
+" spaces, the parameter must be inclosed within quotes.\n"
+" If the first column of a config line is a '#' charac­\n"
+" ter, the rest of the line will be treated as a comment.\n"
"\n"
" Specify the filename as '-' to make curl read the file\n"
" from stdin.\n"
"\n"
+" This option can be used multiple times.\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"
@@ -265,6 +325,9 @@ puts (
" the normal directory view doesn't use a standard look\n"
" or format.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable list only.\n"
+"\n"
" -L/--location\n"
" (HTTP/HTTPS) If the server reports that the requested\n"
" page has a different location (indicated with the\n"
@@ -275,6 +338,9 @@ puts (
" curl will automatically switch to GET after the initial\n"
" POST has been done.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable location following.\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"
@@ -282,6 +348,9 @@ puts (
" links going down. This doesn't work fully in win32\n"
" systems.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
+"\n"
" -M/--manual\n"
" Manual. Display the huge help text.\n"
"\n"
@@ -301,6 +370,9 @@ puts (
"\n"
" machine host.domain.com login myself password secret\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable netrc usage.\n"
+"\n"
" -N/--no-buffer\n"
" Disables the buffering of the output stream. In normal\n"
" work situations, curl will use a standard buffered out­\n"
@@ -309,6 +381,9 @@ puts (
" the data arrives. Using this option will disable that\n"
" buffering.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" switch on buffering.\n"
+"\n"
" -o/--output <file>\n"
" Write output to <file> instead of stdout. If you are\n"
" using {} or [] to fetch multiple documents, you can use\n"
@@ -321,6 +396,10 @@ puts (
" or use several variables like:\n"
"\n"
" curl http://{site,host}.host[1-5].com -o \"#1_#2\"\n"
+"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
@@ -335,6 +414,9 @@ puts (
" nect to the remote port number curl wants to tunnel\n"
" through to.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable proxy tunnel.\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"
@@ -342,7 +424,6 @@ puts (
" server to connect to the client's specified 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"
" address you want to use (Unix only)\n"
"\n"
@@ -354,6 +435,9 @@ puts (
" - (any single-letter string) to make it pick\n"
" the machine's default\n"
"\n"
+" If this option is used serveral times, the last one will be\n"
+" used.\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"
" fig file.\n"
@@ -370,6 +454,8 @@ puts (
" returns failure for one of the commands, the entire\n"
" operation will be aborted.\n"
"\n"
+" This option can be used multiple times.\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"
@@ -403,14 +489,25 @@ puts (
" stop' (optionally with one of the numbers omitted). It\n"
" depends on the non-RFC command SIZE.\n"
"\n"
+" If this option is used serveral times, the last one will be\n"
+" used.\n"
+"\n"
" -s/--silent\n"
" Silent mode. Don't show progress meter or error mes­\n"
" sages. Makes Curl mute.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable mute.\n"
+"\n"
" -S/--show-error\n"
" When used with -s it makes curl show error message if\n"
" it fails.\n"
"\n"
+" If this option is used twice, the second will again\n"
+);
+ puts(
+" disable show error.\n"
+"\n"
" -t/--upload\n"
" Deprecated. Use '-T -' instead. Transfer the stdin\n"
" data to the specified file. Curl will read everything\n"
@@ -429,21 +526,33 @@ puts (
" to fail. If this is used on a http(s) server, the PUT\n"
" command will be used.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" 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"
" interactively.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
+"\n"
" -U/--proxy-user <user:password>\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"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
+"\n"
" -v/--verbose\n"
" Makes the fetching more verbose/talkative. Mostly\n"
" usable for debugging. Lines starting with '>' means\n"
@@ -451,6 +560,9 @@ puts (
" is hidden in normal cases and lines starting with '*'\n"
" means additional info provided by curl.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable verbose.\n"
+"\n"
" -V/--version\n"
" Displays the full version of curl, libcurl and other\n"
" 3rd party libraries linked with the executable.\n"
@@ -469,14 +581,11 @@ puts (
" %{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"
" 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"
" mostly meaningful if you've told curl to\n"
@@ -523,11 +632,16 @@ puts (
"\n"
" speed_upload The average upload speed that curl mea­\n"
" sured for the complete upload.\n"
+" If this option is used serveral times, the last one will be\n"
+" used.\n"
"\n"
" -x/--proxy <proxyhost[:port]>\n"
" Use specified proxy. If the port number is not speci­\n"
" fied, it is assumed at port 1080.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
@@ -537,17 +651,26 @@ puts (
" (FTP) Specifies a custom FTP command to use instead of\n"
" LIST when doing file lists with ftp.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
" aborted. If speed-time is used, the default speed-limit\n"
" will be 1 unless set with -y.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
" speed-time is set with -Y and is 30 if not set.\n"
"\n"
+" If this option is used serveral times, the last one\n"
+" will be used.\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"
@@ -561,6 +684,8 @@ puts (
" 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"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
"\n"
" -3/--sslv3\n"
" (HTTPS) Forces curl to use SSL version 3 when negotiat­\n"
@@ -574,15 +699,25 @@ puts (
" Make curl display progress information as a progress\n"
" bar instead of the default statistics.\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable the progress bar.\n"
+"\n"
" --crlf\n"
" (FTP) Convert LF to CRLF in upload. Useful for MVS\n"
" (OS/390).\n"
"\n"
+" If this option is used twice, the second will again\n"
+" disable crlf converting.\n"
+"\n"
" --stderr <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"
+" If this option is used serveral times, the last one\n"
+" will be used.\n"
+"\n"
"FILES\n"
" ~/.curlrc\n"
" Default config file.\n"
@@ -599,7 +734,6 @@ puts (
"\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"
" is set.\n"
@@ -634,12 +768,15 @@ puts (
" resolved.\n"
"\n"
" 7 Failed to connect to host.\n"
+"\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"
+);
+ puts(
" not accepted by the server.\n"
"\n"
" 11 FTP weird PASS reply. Curl couldn't parse the reply\n"
@@ -650,7 +787,6 @@ puts (
"\n"
" 13 FTP weird PASV reply, Curl couldn't parse the reply\n"
" sent to the PASV request.\n"
-"\n"
" 14 FTP weird 227 format. Curl couldn't parse the 227-line\n"
" the server sent.\n"
"\n"
@@ -685,6 +821,7 @@ puts (
" 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"
@@ -702,7 +839,6 @@ puts (
" 959.\n"
"\n"
" 33 HTTP range error. The range \"command\" didn't work.\n"
-"\n"
" 34 HTTP post error. Internal post-request generation\n"
" error.\n"
"\n"
@@ -736,6 +872,7 @@ puts (
"\n"
" 46 Bad password entered. An error was signalled when the\n"
" password was entered.\n"
+"\n"
" 47 Too many redirects. When following redirects, curl hit\n"
" the maximum amount.\n"
"\n"
@@ -766,8 +903,6 @@ puts (
" - Douglas E. Wegscheid <wegscd@whirlpool.com>\n"
" - Mark Butler <butlerm@xmission.com>\n"
" - Eric Thelin <eric@generation-i.com>\n"
-);
- puts(
" - Marc Boucher <marc@mbsi.ca>\n"
" - Greg Onufer <Greg.Onufer@Eng.Sun.COM>\n"
" - Doug Kaufman <dkaufman@rahul.net>\n"
@@ -807,7 +942,6 @@ puts (
"\n"
"WWW\n"
" http://curl.haxx.se\n"
-"\n"
"FTP\n"
" ftp://ftp.sunet.se/pub/www/utilities/curl/\n"
"\n"
@@ -980,6 +1114,8 @@ puts (
" receives in order to let the user see all client-server interaction.\n"
"\n"
" curl -v ftp://ftp.upload.com/\n"
+);
+ puts(
"\n"
"DETAILED INFORMATION\n"
"\n"
@@ -1076,8 +1212,6 @@ puts (
"\n"
" curl -F \"file=@cooltext.txt\" -F \"yourname=Daniel\" \\\n"
" -F \"filedescription=Cool text file with cool text inside\" \\\n"
-);
- puts(
" http://www.post.com/postit.cgi\n"
"\n"
" So, to send two files in one post you can do it in two ways:\n"
@@ -1227,6 +1361,8 @@ puts (
" 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"
+);
+ puts(
"\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"
@@ -1347,8 +1483,6 @@ puts (
" curl https://www.secure-site.com\n"
"\n"
" Curl is also capable of using your personal certificates to get/post files\n"
-);
- puts(
" from sites that require valid certificates. The only drawback is that the\n"
" certificate needs to be in PEM-format. PEM is a standard and open format to\n"
" store certificates with, but it is not used by the most commonly used\n"
@@ -1519,6 +1653,8 @@ puts (
" authentication is used.\n"
"\n"
" A very simple .netrc file could look something like:\n"
+);
+ puts(
"\n"
" machine curl.haxx.se login iamdaniel password mysecret\n"
"\n"