cmdline-opts: made the 'Added:' field mandatory

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

docs/cmdline-opts/anyauth.d

@@ -4,6 +4,7 @@ Protocols: HTTP
 See-also: proxy-anyauth basic digest
 Category: http proxy auth
 Example: --anyauth --user me:pwd $URL
+Added: 7.10.6
 ---
 Tells curl to figure out authentication method by itself, and use the most
 secure one the remote site claims to support. This is done by first doing a

docs/cmdline-opts/append.d

@@ -4,6 +4,7 @@ Help: Append to target file when uploading
 Protocols: FTP SFTP
 Category: ftp sftp
 Example: --upload-file local --append ftp://example.com/
+Added: 4.8
 ---
 When used in an upload, this makes curl append to the target file instead of
 overwriting it. If the remote file doesn't exist, it will be created.  Note

docs/cmdline-opts/basic.d

@@ -4,6 +4,7 @@ See-also: proxy-basic
 Protocols: HTTP
 Category: auth
 Example: -u name:password --basic $URL
+Added: 7.10.6
 ---
 Tells curl to use HTTP Basic authentication with the remote host. This is the
 default and this option is usually pointless, unless you use it to override a

docs/cmdline-opts/cacert.d

@@ -4,6 +4,7 @@ Help: CA certificate to verify peer against
 Protocols: TLS
 Category: tls
 Example: --cacert CA-file.txt $URL
+Added: 7.5
 ---
 Tells curl to use the specified certificate file to verify the peer. The file
 may contain multiple CA certificates. The certificate(s) must be in PEM

docs/cmdline-opts/capath.d

@@ -4,6 +4,7 @@ Help: CA directory to verify peer against
 Protocols: TLS
 Category: tls
 Example: --capath /local/directory $URL
+Added: 7.9.8
 ---
 Tells curl to use the specified certificate directory to verify the
 peer. Multiple paths can be provided by separating them with ":" (e.g.

docs/cmdline-opts/cert-type.d

@@ -5,6 +5,7 @@ Help: Certificate type (DER/PEM/ENG)
 See-also: cert key key-type
 Category: tls
 Example: --cert-type PEM --cert file $URL
+Added: 7.9.3
 ---
 Tells curl what type the provided client certificate is using. PEM, DER, ENG
 and P12 are recognized types.  If not specified, PEM is assumed.

docs/cmdline-opts/cert.d

@@ -6,6 +6,7 @@ Protocols: TLS
 See-also: cert-type key key-type
 Category: tls
 Example: --cert certfile --key keyfile $URL
+Added: 5.0
 ---
 Tells curl to use the specified client certificate file when getting a file
 with HTTPS, FTPS or another SSL-based protocol. The certificate must be in

docs/cmdline-opts/ciphers.d

@@ -4,6 +4,7 @@ Help: SSL ciphers to use
 Protocols: TLS
 Category: tls
 Example: --ciphers ECDHE-ECDSA-AES256-CCM8 $URL
+Added: 7.9
 ---
 Specifies which ciphers to use in the connection. The list of ciphers must
 specify valid ciphers. Read up on SSL cipher list details on this URL:

docs/cmdline-opts/compressed.d

@@ -3,6 +3,7 @@ Help: Request compressed response
 Protocols: HTTP
 Category: http
 Example: --compressed $URL
+Added: 7.10
 ---
 Request a compressed response using one of the algorithms curl supports, and
 automatically decompress the content. Headers are not modified.

docs/cmdline-opts/config.d

@@ -4,8 +4,8 @@ Help: Read config from a file
 Short: K
 Category: curl
 Example: --config file.txt $URL
+Added: 4.10
 ---
-
 Specify a text file to read curl arguments from. The command line arguments
 found in the text file will be used as if they were provided on the command
 line.

docs/cmdline-opts/connect-timeout.d

@@ -5,6 +5,7 @@ See-also: max-time
 Category: connection
 Example: --connect-timeout 20 $URL
 Example: --connect-timeout 3.14 $URL
+Added: 7.7
 ---
 Maximum time in seconds that you allow curl's connection to take.  This only
 limits the connection phase, so if curl connects within the given period it

docs/cmdline-opts/continue-at.d

@@ -6,6 +6,7 @@ See-also: range
 Category: connection
 Example: -C - $URL
 Example: -C 400 $URL
+Added: 4.8
 ---
 Continue/Resume a previous file transfer at the given offset. The given offset
 is the exact number of bytes that will be skipped, counting from the beginning

docs/cmdline-opts/cookie-jar.d

@@ -6,6 +6,7 @@ Help: Write cookies to <filename> after operation
 Category: http
 Example: -c store-here.txt $URL
 Example: -c store-here.txt -b read-these $URL
+Added: 7.9
 ---
 Specify to which file you want curl to write all cookies after a completed
 operation. Curl writes all cookies from its in-memory cookie storage to the

docs/cmdline-opts/cookie.d

@@ -6,6 +6,7 @@ Help: Send cookies from string/file
 Category: http
 Example: -b cookiefile $URL
 Example: -b cookiefile -c cookiefile $URL
+Added: 4.9
 ---
 Pass the data to the HTTP server in the Cookie header. It is supposedly
 the data previously received from the server in a "Set-Cookie:" line.  The

docs/cmdline-opts/create-dirs.d

@@ -2,6 +2,7 @@ Long: create-dirs
 Help: Create necessary local directory hierarchy
 Category: curl
 Example: --create-dirs --output local/dir/file $URL
+Added: 7.10.3
 ---
 When used in conjunction with the --output option, curl will create the
 necessary local directory hierarchy as needed. This option creates the

docs/cmdline-opts/crlf.d

@@ -3,6 +3,7 @@ Help: Convert LF to CRLF in upload
 Protocols: FTP SMTP
 Category: ftp smtp
 Example: --crlf -T file ftp://example.com/
+Added: 5.7
 ---
 Convert LF to CRLF in upload. Useful for MVS (OS/390).
 

docs/cmdline-opts/data-ascii.d

@@ -4,5 +4,6 @@ Help: HTTP POST ASCII data
 Protocols: HTTP
 Category: http post upload
 Example: --data-ascii @file $URL
+Added: 7.2
 ---
 This is just an alias for --data.

docs/cmdline-opts/data-binary.d

@@ -4,6 +4,7 @@ Help: HTTP POST binary data
 Protocols: HTTP
 Category: http post upload
 Example: --data-binary @filename $URL
+Added: 7.2
 ---
 This posts data exactly as specified with no extra processing whatsoever.
 

docs/cmdline-opts/data.d

@@ -9,6 +9,7 @@ Category: important http post upload
 Example: -d "name=curl" $URL
 Example: -d "name=curl" -d "tool=cmdline" $URL
 Example: -d @filename $URL
+Added: 4.0
 ---
 Sends the specified data in a POST request to the HTTP server, in the same way
 that a browser does when a user has filled in an HTML form and presses the

docs/cmdline-opts/delegation.d

@@ -4,6 +4,7 @@ Help: GSS-API delegation permission
 Protocols: GSS/kerberos
 Category: auth
 Example: --delegation "none" $URL
+Added: 7.22.0
 ---
 Set LEVEL to tell the server what it is allowed to delegate when it
 comes to user credentials.

docs/cmdline-opts/digest.d

@@ -5,6 +5,7 @@ Mutexed: basic ntlm negotiate
 See-also: user proxy-digest anyauth
 Category: proxy auth http
 Example: -u name:password --digest $URL
+Added: 7.10.6
 ---
 Enables HTTP Digest authentication. This is an authentication scheme that
 prevents the password from being sent over the wire in clear text. Use this in

docs/cmdline-opts/disable-eprt.d

@@ -3,6 +3,7 @@ Help: Inhibit using EPRT or LPRT
 Protocols: FTP
 Category: ftp
 Example: --disable-eprt ftp://example.com/
+Added: 7.10.5
 ---
 Tell curl to disable the use of the EPRT and LPRT commands when doing active
 FTP transfers. Curl will normally always first attempt to use EPRT, then LPRT

docs/cmdline-opts/disable-epsv.d

@@ -3,6 +3,7 @@ Help: Inhibit using EPSV
 Protocols: FTP
 Category: ftp
 Example: --disable-epsv ftp://example.com/
+Added: 7.9.2
 ---
 Tell curl to disable the use of the EPSV command when doing passive FTP
 transfers. Curl will normally always first attempt to use EPSV before

docs/cmdline-opts/disable.d

@@ -3,6 +3,7 @@ Short: q
 Help: Disable .curlrc
 Category: curl
 Example: -q $URL
+Added: 5.0
 ---
 If used as the first parameter on the command line, the *curlrc* config
 file will not be read and used. See the --config for details on the default

docs/cmdline-opts/dump-header.d

@@ -6,6 +6,7 @@ Protocols: HTTP FTP
 See-also: output
 Category: http ftp
 Example: --dump-header store.txt $URL
+Added: 5.7
 ---
 Write the received protocol headers to the specified file. If no headers are
 received, the use of this option will create an empty file.

docs/cmdline-opts/egd-file.d

@@ -5,6 +5,7 @@ Protocols: TLS
 See-also: random-file
 Category: tls
 Example: --egd-file /random/here $URL
+Added: 7.7
 ---
 Specify the path name to the Entropy Gathering Daemon socket. The socket is
 used to seed the random engine for SSL connections.

docs/cmdline-opts/engine.d

@@ -4,6 +4,7 @@ Help: Crypto engine to use
 Protocols: TLS
 Category: tls
 Example: --engine flavor $URL
+Added: 7.9.3
 ---
 Select the OpenSSL crypto engine to use for cipher operations. Use --engine
 list to print a list of build-time supported engines. Note that not all (and

docs/cmdline-opts/fail.d

@@ -5,6 +5,7 @@ Help: Fail silently (no output at all) on HTTP errors
 See-also: fail-with-body
 Category: important http
 Example: --fail $URL
+Added: 4.0
 ---
 Fail silently (no output at all) on server errors. This is mostly done to
 enable scripts etc to better deal with failed attempts. In normal cases

docs/cmdline-opts/form-string.d

@@ -5,6 +5,7 @@ Arg: <name=string>
 See-also: form
 Category: http upload
 Example: --form-string "data" $URL
+Added: 7.13.2
 ---
 Similar to --form except that the value string for the named parameter is used
 literally. Leading \&'@' and \&'<' characters, and the \&';type=' string in

docs/cmdline-opts/form.d

@@ -6,6 +6,7 @@ Protocols: HTTP SMTP IMAP
 Mutexed: data head upload-file
 Category: http upload
 Example: --form "name=curl" --form "file=@loadthis" $URL
+Added: 5.0
 ---
 For HTTP protocol family, this lets curl emulate a filled-in form in which a
 user has pressed the submit button. This causes curl to POST data using the

docs/cmdline-opts/ftp-create-dirs.d

@@ -4,6 +4,7 @@ Help: Create the remote dirs if not present
 See-also: create-dirs
 Category: ftp sftp curl
 Example: --ftp-create-dirs -T file ftp://example.com/remote/path/file
+Added: 7.10.7
 ---
 When an FTP or SFTP URL/operation uses a path that doesn't currently exist on
 the server, the standard behavior of curl is to fail. Using this option, curl

docs/cmdline-opts/ftp-port.d

@@ -8,6 +8,7 @@ Category: ftp
 Example: -P - ftp:/example.com
 Example: -P eth0 ftp:/example.com
 Example: -P 192.168.0.2 ftp:/example.com
+Added: 4.0
 ---
 Reverses the default initiator/listener roles when connecting with FTP. This
 option makes curl use active mode. curl then tells the server to connect back

docs/cmdline-opts/gen.pl

@@ -135,13 +135,17 @@ sub protocols {
 
 sub too_old {
     my ($version)=@_;
+    my $a = 999999;
     if($version =~ /^(\d+)\.(\d+)\.(\d+)/) {
-        my $a = $1 * 1000 + $2 * 10 + $3;
-        if($a < 7300) {
-            # we consider everything before 7.30.0 to be too old to mention
-            # specific changes for
-            return 1;
-        }
+        $a = $1 * 1000 + $2 * 10 + $3;
+    }
+    elsif($version =~ /^(\d+)\.(\d+)/) {
+        $a = $1 * 1000 + $2 * 10;
+    }
+    if($a < 7300) {
+        # we consider everything before 7.30.0 to be too old to mention
+        # specific changes for
+        return 1;
     }
     return 0;
 }
@@ -231,6 +235,10 @@ sub single {
                 print STDERR "$f:$line:1:ERROR: no 'Example:' present\n";
                 exit 2;
             }
+            if(!$added) {
+                print STDERR "$f:$line:1:ERROR: no 'Added:' version present\n";
+                exit 2;
+            }
             last;
         }
         else {

docs/cmdline-opts/get.d

@@ -5,6 +5,7 @@ Category: http upload
 Example: --get $URL
 Example: --get -d "tool=curl" -d "age=old" $URL
 Example: --get -I -d "tool=curl" $URL
+Added: 7.8.1
 ---
 When used, this option will make all data specified with --data, --data-binary
 or --data-urlencode to be used in an HTTP GET request instead of the POST

docs/cmdline-opts/globoff.d

@@ -3,6 +3,7 @@ Short: g
 Help: Disable URL sequences and ranges using {} and []
 Category: curl
 Example: -g "https://example.com/{[]}}}}"
+Added: 7.6
 ---
 This option switches off the "URL globbing parser". When you set this option,
 you can specify URLs that contain the letters {}[] without having curl itself

docs/cmdline-opts/head.d

@@ -4,6 +4,7 @@ Help: Show document info only
 Protocols: HTTP FTP FILE
 Category: http ftp file
 Example: -I $URL
+Added: 4.0
 ---
 Fetch the headers only! HTTP-servers feature the command HEAD which this uses
 to get nothing but the header of a document. When used on an FTP or FILE file,

docs/cmdline-opts/header.d

@@ -8,6 +8,7 @@ See-also: user-agent referer
 Example: -H "X-First-Name: Joe" $URL
 Example: -H "User-Agent: yes-please/2000" $URL
 Example: -H "Host:" $URL
+Added: 5.0
 ---
 Extra header to include in the request when sending HTTP to a server. You may
 specify any number of extra headers. Note that if you should add a custom

docs/cmdline-opts/help.d

@@ -4,6 +4,7 @@ Short: h
 Help: Get help for commands
 Category: important curl
 Example: --help all
+Added: 4.0
 ---
 Usage help. This lists all commands of the <category>.
 If no arg was provided, curl will display the most important

docs/cmdline-opts/http0.9.d

@@ -1,10 +1,10 @@
 Long: http0.9
 Tags: Versions
 Protocols: HTTP
-Added:
 Help: Allow HTTP 0.9 responses
 Category: http
 Example: --http0.9 $URL
+Added: 7.64.0
 ---
 Tells curl to be fine with HTTP version 0.9 response.
 

docs/cmdline-opts/http1.0.d

@@ -2,7 +2,7 @@ Short: 0
 Long: http1.0
 Tags: Versions
 Protocols: HTTP
-Added:
+Added: 7.9.1
 Mutexed: http1.1 http2
 Help: Use HTTP 1.0
 Category: http

docs/cmdline-opts/ignore-content-length.d

@@ -3,6 +3,7 @@ Help: Ignore the size of the remote resource
 Protocols: FTP HTTP
 Category: http ftp
 Example: --ignore-content-length $URL
+Added: 7.14.1
 ---
 For HTTP, Ignore the Content-Length header. This is particularly useful for
 servers running Apache 1.x, which will report incorrect Content-Length for

docs/cmdline-opts/include.d

@@ -4,6 +4,7 @@ Help: Include protocol response headers in the output
 See-also: verbose
 Category: important verbose
 Example: -i $URL
+Added: 4.8
 ---
 Include the HTTP response headers in the output. The HTTP response headers can
 include things like server name, cookies, date of the document, HTTP version

docs/cmdline-opts/insecure.d

@@ -5,6 +5,7 @@ Protocols: TLS
 See-also: proxy-insecure cacert
 Category: tls
 Example: --insecure $URL
+Added: 7.10
 ---
 By default, every SSL connection curl makes is verified to be secure. This
 option allows curl to proceed and operate even for server connections

docs/cmdline-opts/interface.d

@@ -4,8 +4,8 @@ Help: Use network INTERFACE (or address)
 See-also: dns-interface
 Category: connection
 Example: --interface eth0 $URL
+Added: 7.3
 ---
-
 Perform an operation using a specified interface. You can enter interface
 name, IP address or host name. An example could look like:
 

docs/cmdline-opts/ipv4.d

@@ -2,7 +2,7 @@ Short: 4
 Long: ipv4
 Tags: Versions
 Protocols:
-Added:
+Added: 7.10.8
 Mutexed: ipv6
 Requires:
 See-also: http1.1 http2

docs/cmdline-opts/ipv6.d

@@ -2,7 +2,7 @@ Short: 6
 Long: ipv6
 Tags: Versions
 Protocols:
-Added:
+Added: 7.10.8
 Mutexed: ipv4
 Requires:
 See-also: http1.1 http2

docs/cmdline-opts/junk-session-cookies.d

@@ -5,6 +5,7 @@ Protocols: HTTP
 See-also: cookie cookie-jar
 Category: http
 Example: --junk-session-cookies -b cookies.txt $URL
+Added: 7.9.7
 ---
 When curl is told to read cookies from a given file, this option will make it
 discard all "session cookies". This will basically have the same effect as if

docs/cmdline-opts/key-type.d

@@ -4,6 +4,7 @@ Help: Private key file type (DER/PEM/ENG)
 Protocols: TLS
 Category: tls
 Example: --key-type DER --key here $URL
+Added: 7.9.3
 ---
 Private key file type. Specify which type your --key provided private key
 is. DER, PEM, and ENG are supported. If not specified, PEM is assumed.

docs/cmdline-opts/key.d

@@ -4,6 +4,7 @@ Protocols: TLS SSH
 Help: Private key file name
 Category: tls ssh
 Example: --cert certificate --key here $URL
+Added: 7.9.3
 ---
 Private key file name. Allows you to provide your private key in this separate
 file. For SSH, if not specified, curl tries the following candidates in order:

docs/cmdline-opts/krb.d

@@ -5,6 +5,7 @@ Protocols: FTP
 Requires: Kerberos
 Category: ftp
 Example: --krb clear ftp://example.com/
+Added: 7.3
 ---
 Enable Kerberos authentication and use. The level must be entered and should
 be one of 'clear', 'safe', 'confidential', or 'private'. Should you use a

docs/cmdline-opts/limit-rate.d

@@ -5,6 +5,7 @@ Category: connection
 Example: --limit-rate 100K $URL
 Example: --limit-rate 1000 $URL
 Example: --limit-rate 10M $URL
+Added: 7.10
 ---
 Specify the maximum transfer rate you want curl to use - for both downloads
 and uploads. This feature is useful if you have a limited pipe and you'd like

docs/cmdline-opts/location-trusted.d

@@ -4,6 +4,7 @@ Protocols: HTTP
 See-also: user
 Category: http auth
 Example: --location-trusted -u user:password $URL
+Added: 7.10.4
 ---
 Like --location, but will allow sending the name + password to all hosts that
 the site may redirect to. This may or may not introduce a security breach if

docs/cmdline-opts/location.d

@@ -4,6 +4,7 @@ Help: Follow redirects
 Protocols: HTTP
 Category: http
 Example: -L $URL
+Added: 4.9
 ---
 If the server reports that the requested page has moved to a different
 location (indicated with a Location: header and a 3XX response code), this

docs/cmdline-opts/manual.d

@@ -3,5 +3,6 @@ Short: M
 Help: Display the full manual
 Category: curl
 Example: --manual
+Added: 5.2
 ---
 Manual. Display the huge help text.

docs/cmdline-opts/max-filesize.d

@@ -5,6 +5,7 @@ Protocols: FTP HTTP MQTT
 See-also: limit-rate
 Category: connection
 Example: --max-filesize 100K $URL
+Added: 7.10.8
 ---
 Specify the maximum size (in bytes) of a file to download. If the file
 requested is larger than this value, the transfer will not start and curl will

docs/cmdline-opts/max-redirs.d

@@ -4,6 +4,7 @@ Help: Maximum number of redirects allowed
 Protocols: HTTP
 Category: http
 Example: --max-redirs 3 --location $URL
+Added: 7.5
 ---
 Set maximum number of redirections to follow. When --location is used, to
 prevent curl from following too many redirects, by default, the limit is

docs/cmdline-opts/max-time.d

@@ -6,6 +6,7 @@ See-also: connect-timeout
 Category: connection
 Example: --max-time 10 $URL
 Example: --max-time 2.92 $URL
+Added: 4.0
 ---
 Maximum time in seconds that you allow the whole operation to take.  This is
 useful for preventing your batch jobs from hanging for hours due to slow

docs/cmdline-opts/negotiate.d

@@ -4,6 +4,7 @@ Protocols: HTTP
 See-also: basic ntlm anyauth proxy-negotiate
 Category: auth http
 Example: --negotiate -u : $URL
+Added: 7.10.6
 ---
 Enables Negotiate (SPNEGO) authentication.
 

docs/cmdline-opts/netrc-optional.d

@@ -4,6 +4,7 @@ Mutexed: netrc
 See-also: netrc-file
 Category: curl
 Example: --netrc-optional $URL
+Added: 7.9.8
 ---
 Very similar to --netrc, but this option makes the .netrc usage **optional**
 and not mandatory as the --netrc option does.

docs/cmdline-opts/netrc.d

@@ -3,6 +3,7 @@ Short: n
 Help: Must read .netrc for user name and password
 Category: curl
 Example: --netrc $URL
+Added: 4.6
 ---
 Makes curl scan the *.netrc* (*_netrc* on Windows) file in the user's home
 directory for login name and password. This is typically used for FTP on

docs/cmdline-opts/no-buffer.d

@@ -3,6 +3,7 @@ Short: N
 Help: Disable buffering of the output stream
 Category: curl
 Example: --no-buffer $URL
+Added: 6.5
 ---
 Disables the buffering of the output stream. In normal work situations, curl
 will use a standard buffered output stream that will have the effect that it

docs/cmdline-opts/no-keepalive.d

@@ -2,6 +2,7 @@ Long: no-keepalive
 Help: Disable TCP keepalive on the connection
 Category: connection
 Example: --no-keepalive $URL
+Added: 7.18.0
 ---
 Disables the use of keepalive messages on the TCP connection. curl otherwise
 enables them by default.

docs/cmdline-opts/ntlm-wb.d

@@ -4,6 +4,7 @@ Protocols: HTTP
 See-also: ntlm proxy-ntlm
 Category: auth http
 Example: --ntlm-wb -u user:password $URL
+Added: 7.22.0
 ---
 Enables NTLM much in the style --ntlm does, but hand over the authentication
 to the separate binary ntlmauth application that is executed when needed.

docs/cmdline-opts/ntlm.d

@@ -6,6 +6,7 @@ Protocols: HTTP
 Requires: TLS
 Category: auth http
 Example: --ntlm -u user:password $URL
+Added: 7.10.6
 ---
 Enables NTLM authentication. The NTLM authentication method was designed by
 Microsoft and is used by IIS web servers. It is a proprietary protocol,

docs/cmdline-opts/oauth2-bearer.d

@@ -4,6 +4,7 @@ Arg: <token>
 Protocols: IMAP POP3 SMTP HTTP
 Category: auth
 Example: --oauth2-bearer "mF_9.B5f-4.1JqM" $URL
+Added: 7.33.0
 ---
 Specify the Bearer Token for OAUTH 2.0 server authentication. The Bearer Token
 is used in conjunction with the user name which can be specified as part of

docs/cmdline-opts/output.d

@@ -8,6 +8,7 @@ Example: -o file $URL
 Example: "http://{one,two}.example.com" -o "file_#1.txt"
 Example: "http://{site,host}.host[1-5].com" -o "#1_#2"
 Example: -o file $URL -o file2 https://example.net
+Added: 4.0
 ---
 Write output to <file> instead of stdout. If you are using {} or [] to fetch
 multiple documents, you should quote the URL and you can use '#' followed by a

docs/cmdline-opts/pass.d

@@ -4,6 +4,7 @@ Help: Pass phrase for the private key
 Protocols: SSH TLS
 Category: ssh tls auth
 Example: --pass secret --key file $URL
+Added: 7.9.3
 ---
 Passphrase for the private key.
 

docs/cmdline-opts/pinnedpubkey.d

@@ -5,6 +5,7 @@ Protocols: TLS
 Category: tls
 Example: --pinnedpubkey keyfile $URL
 Example: --pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
+Added: 7.39.0
 ---
 Tells curl to use the specified public key file (or hashes) to verify the
 peer. This can be a path to a file which contains a single public key in PEM

docs/cmdline-opts/progress-bar.d

@@ -3,6 +3,7 @@ Long: progress-bar
 Help: Display transfer progress as a bar
 Category: verbose
 Example: -# -O $URL
+Added: 5.10
 ---
 Make curl display transfer progress as a simple progress bar instead of the
 standard, more informational, meter.

docs/cmdline-opts/proxy-basic.d

@@ -3,6 +3,7 @@ Help: Use Basic authentication on the proxy
 See-also: proxy proxy-anyauth proxy-digest
 Category: proxy auth
 Example: --proxy-basic --proxy-user user:passwd -x proxy $URL
+Added: 7.12.0
 ---
 Tells curl to use HTTP Basic authentication when communicating with the given
 proxy. Use --basic for enabling HTTP Basic with a remote host. Basic is the

docs/cmdline-opts/proxy-digest.d

@@ -3,6 +3,7 @@ Help: Use Digest authentication on the proxy
 See-also: proxy proxy-anyauth proxy-basic
 Category: proxy tls
 Example: --proxy-digest --proxy-user user:passwd -x proxy $URL
+Added: 7.12.0
 ---
 Tells curl to use HTTP Digest authentication when communicating with the given
 proxy. Use --digest for enabling HTTP Digest with a remote host.

docs/cmdline-opts/proxy-key.d

@@ -3,5 +3,6 @@ Help: Private key for HTTPS proxy
 Arg: <key>
 Category: proxy tls
 Example: --proxy-key here -x https://proxy $URL
+Added: 7.52.0
 ---
 Same as --key but used in HTTPS proxy context.

docs/cmdline-opts/proxy-ntlm.d

@@ -3,6 +3,7 @@ Help: Use NTLM authentication on the proxy
 See-also: proxy-negotiate proxy-anyauth
 Category: proxy auth
 Example: --proxy-ntlm --proxy-user user:passwd -x http://proxy $URL
+Added: 7.10.7
 ---
 Tells curl to use HTTP NTLM authentication when communicating with the given
 proxy. Use --ntlm for enabling NTLM with a remote host.

docs/cmdline-opts/proxy-pinnedpubkey.d

@@ -5,6 +5,7 @@ Protocols: TLS
 Category: proxy tls
 Example: --proxy-pinnedpubkey keyfile $URL
 Example: --proxy-pinnedpubkey 'sha256//ce118b51897f4452dc' $URL
+Added: 7.59.0
 ---
 Tells curl to use the specified public key file (or hashes) to verify the
 proxy. This can be a path to a file which contains a single public key in PEM

docs/cmdline-opts/proxy-tls13-ciphers.d

@@ -4,6 +4,7 @@ help: TLS 1.3 proxy cipher suites
 Protocols: TLS
 Category: proxy tls
 Example: --proxy-tls13-ciphers TLS_AES_128_GCM_SHA256 -x proxy $URL
+Added: 7.61.0
 ---
 Specifies which cipher suites to use in the connection to your HTTPS proxy
 when it negotiates TLS 1.3. The list of ciphers suites must specify valid

docs/cmdline-opts/proxy-user.d

@@ -4,6 +4,7 @@ Arg: <user:password>
 Help: Proxy user and password
 Category: proxy auth
 Example: --proxy-user name:pwd -x proxy $URL
+Added: 4.0
 ---
 Specify the user name and password to use for proxy authentication.
 

docs/cmdline-opts/proxy.d

@@ -4,6 +4,7 @@ Arg: [protocol://]host[:port]
 Help: Use this proxy
 Category: proxy
 Example: --proxy http://proxy.example $URL
+Added: 4.0
 ---
 Use the specified proxy.
 

docs/cmdline-opts/proxy1.0.d

@@ -3,6 +3,7 @@ Arg: <host[:port]>
 Help: Use HTTP/1.0 proxy on given port
 Category: proxy
 Example: --proxy1.0 -x http://proxy $URL
+Added: 7.19.4
 ---
 Use the specified HTTP 1.0 proxy. If the port number is not specified, it is
 assumed at port 1080.

docs/cmdline-opts/proxytunnel.d

@@ -4,6 +4,7 @@ Help: Operate through an HTTP proxy tunnel (using CONNECT)
 See-also: proxy
 Category: proxy
 Example: --proxytunnel -x http://proxy $URL
+Added: 7.3
 ---
 When an HTTP proxy is used --proxy, this option will make curl tunnel through
 the proxy. The tunnel approach is made with the HTTP proxy CONNECT request and

docs/cmdline-opts/pubkey.d

@@ -4,6 +4,7 @@ Protocols: SFTP SCP
 Help: SSH Public key file name
 Category: sftp scp auth
 Example: --pubkey file.pub sftp://example.com/
+Added: 7.16.2
 ---
 Public key file name. Allows you to provide your public key in this separate
 file.

docs/cmdline-opts/quote.d

@@ -5,6 +5,7 @@ Help: Send command(s) to server before transfer
 Protocols: FTP SFTP
 Category: ftp sftp
 Example: --quote "DELE file" ftp://example.com/foo
+Added: 5.3
 ---
 Send an arbitrary command to the remote FTP or SFTP server. Quote commands are
 sent BEFORE the transfer takes place (just after the initial PWD command in an

docs/cmdline-opts/random-file.d

@@ -3,6 +3,7 @@ Arg: <file>
 Help: File for reading random data from
 Category: misc
 Example: --random-file rubbish $URL
+Added: 7.7
 ---
 Specify the path name to file containing what will be considered as random
 data. The data may be used to seed the random engine for SSL connections.  See

docs/cmdline-opts/range.d

@@ -5,6 +5,7 @@ Arg: <range>
 Protocols: HTTP FTP SFTP FILE
 Category: http ftp sftp file
 Example: --range 22-44 $URL
+Added: 4.0
 ---
 Retrieve a byte range (i.e. a partial document) from an HTTP/1.1, FTP or SFTP
 server or a local FILE. Ranges can be specified in a number of ways.

docs/cmdline-opts/referer.d

@@ -8,6 +8,7 @@ Category: http
 Example: --referer "https://fake.example" $URL
 Example: --referer "https://fake.example;auto" -L $URL
 Example: --referer ";auto" -L $URL
+Added: 4.0
 ---
 Sends the "Referrer Page" information to the HTTP server. This can also be set
 with the --header flag of course.  When used with --location you can append

docs/cmdline-opts/remote-header-name.d

@@ -4,6 +4,7 @@ Protocols: HTTP
 Help: Use the header-provided filename
 Category: output
 Example: -OJ https://example.com/file
+Added: 7.20.0
 ---
 This option tells the --remote-name option to use the server-specified
 Content-Disposition filename instead of extracting a filename from the URL.

docs/cmdline-opts/remote-name.d

@@ -3,6 +3,7 @@ Short: O
 Help: Write output to a file named as the remote file
 Category: important output
 Example: -O https://example.com/filename
+Added: 4.0
 ---
 Write output to a local file named like the remote file we get. (Only the file
 part of the remote file is used, the path is cut off.)

docs/cmdline-opts/remote-time.d

@@ -3,6 +3,7 @@ Short: R
 Help: Set the remote file's time on the local output
 Category: output
 Example: --remote-time -o foo $URL
+Added: 7.9
 ---
 When used, this will make curl attempt to figure out the timestamp of the
 remote file, and if that is available make the local file get that same

docs/cmdline-opts/request.d

@@ -5,6 +5,7 @@ Help: Specify request command to use
 Category: connection
 Example: -X "DELETE" $URL
 Example: -X NLST ftp://example.com/
+Added: 6.0
 ---
 (HTTP) Specifies a custom request method to use when communicating with the
 HTTP server.  The specified request method will be used instead of the method

docs/cmdline-opts/show-error.d

@@ -4,6 +4,7 @@ Help: Show error even when -s is used
 See-also: no-progress-meter
 Category: curl
 Example: --show-error --silent $URL
+Added: 5.9
 ---
 When used with --silent, it makes curl show an error message if it fails.
 

docs/cmdline-opts/silent.d

@@ -4,6 +4,7 @@ Help: Silent mode
 See-also: verbose stderr no-progress-meter
 Category: important verbose
 Example: -s $URL
+Added: 4.0
 ---
 Silent or quiet mode. Don't show progress meter or error messages.  Makes Curl
 mute. It will still output the data you ask for, potentially even to the

docs/cmdline-opts/speed-limit.d

@@ -4,6 +4,7 @@ Arg: <speed>
 Help: Stop transfers slower than this
 Category: connection
 Example: --speed-limit 300 --speed-time 10 $URL
+Added: 4.7
 ---
 If a download is slower than this given speed (in bytes per second) for
 speed-time seconds it gets aborted. speed-time is set with --speed-time and is

docs/cmdline-opts/speed-time.d

@@ -4,6 +4,7 @@ Arg: <seconds>
 Help: Trigger 'speed-limit' abort after this time
 Category: connection
 Example: --speed-limit 300 --speed-time 10 $URL
+Added: 4.7
 ---
 If a download is slower than speed-limit bytes per second during a speed-time
 period, the download gets aborted. If speed-time is used, the default

docs/cmdline-opts/sslv2.d

@@ -2,7 +2,7 @@ Short: 2
 Long: sslv2
 Tags: Versions
 Protocols: SSL
-Added:
+Added: 5.9
 Mutexed: sslv3 tlsv1 tlsv1.1 tlsv1.2
 Requires: TLS
 See-also: http1.1 http2

docs/cmdline-opts/sslv3.d

@@ -2,7 +2,7 @@ Short: 3
 Long: sslv3
 Tags: Versions
 Protocols: SSL
-Added:
+Added: 5.9
 Mutexed: sslv2 tlsv1 tlsv1.1 tlsv1.2
 Requires: TLS
 See-also: http1.1 http2

docs/cmdline-opts/stderr.d

@@ -4,6 +4,7 @@ Help: Where to redirect stderr
 See-also: verbose silent
 Category: verbose
 Example: --stderr output.txt $URL
+Added: 6.2
 ---
 Redirect all writes to stderr to the specified file instead. If the file name
 is a plain '-', it is instead written to stdout.

docs/cmdline-opts/suppress-connect-headers.d

@@ -3,6 +3,7 @@ Help: Suppress proxy CONNECT response headers
 See-also: dump-header include proxytunnel
 Category: proxy
 Example: --suppress-connect-headers --include -x proxy $URL
+Added: 7.54.0
 ---
 When --proxytunnel is used and a CONNECT request is made don't output proxy
 CONNECT response headers. This option is meant to be used with --dump-header or

docs/cmdline-opts/telnet-option.d

@@ -4,6 +4,7 @@ Arg: <opt=val>
 Help: Set telnet option
 Category: telnet
 Example: -t TTYPE=vt100 telnet://example.com/
+Added: 7.7
 ---
 Pass options to the telnet protocol. Supported options are:
 

docs/cmdline-opts/time-cond.d

@@ -7,6 +7,7 @@ Category: http ftp
 Example: -z "Wed 01 Sep 2021 12:18:00" $URL
 Example: -z "-Wed 01 Sep 2021 12:18:00" $URL
 Example: -z file $URL
+Added: 5.8
 ---
 Request a file that has been modified later than the given time and date, or
 one that has been modified before that time. The <date expression> can be all

docs/cmdline-opts/tls13-ciphers.d

@@ -4,6 +4,7 @@ help: TLS 1.3 cipher suites to use
 Protocols: TLS
 Category: tls
 Example: --tls13-ciphers TLS_AES_128_GCM_SHA256 $URL
+Added: 7.61.0
 ---
 Specifies which cipher suites to use in the connection if it negotiates TLS
 1.3. The list of ciphers suites must specify valid ciphers. Read up on TLS 1.3

docs/cmdline-opts/tlsv1.d

@@ -2,7 +2,7 @@ Short: 1
 Long: tlsv1
 Tags: Versions
 Protocols: SSL
-Added:
+Added: 7.9.2
 Mutexed: tlsv1.1 tlsv1.2 tlsv1.3
 Requires: TLS
 See-also: http1.1 http2