cmdline-opts: shorter help texts

In an effort to increase the readability of the "--help all" output on
narrow (80 column) terminals.

Co-authored-by: Jay Satiro
Closes #13169

diff --git a/docs/cmdline-opts/aws-sigv4.md b/docs/cmdline-opts/aws-sigv4.md
index 1b3909244f02eebaefb4fd7ccc678d7e85eb49bf..517cc1c5b08b6c196e9e1915c8aef9d907101866 100644 (file)
--- a/docs/cmdline-opts/aws-sigv4.md
+++ b/docs/cmdline-opts/aws-sigv4.md
@@ -3,8 +3,8 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: aws-sigv4
 Protocols: HTTP
-Arg: <provider1[:provider2[:region[:service]]]>
-Help: Use AWS V4 signature authentication
+Arg: <provider1[:prvdr2[:reg[:srv]]]>
+Help: AWS V4 signature auth
 Category: auth http
 Added: 7.75.0
 Multi: single

diff --git a/docs/cmdline-opts/basic.md b/docs/cmdline-opts/basic.md
index abb516aa03673d63a590f6cbf0596bb75175e842..16acd4cb6038516d765a33484a48df9123de0f1f 100644 (file)
--- a/docs/cmdline-opts/basic.md
+++ b/docs/cmdline-opts/basic.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: basic
-Help: Use HTTP Basic Authentication
+Help: HTTP Basic Authentication
 Protocols: HTTP
 Category: auth
 Added: 7.10.6

diff --git a/docs/cmdline-opts/ca-native.md b/docs/cmdline-opts/ca-native.md
index aac7456e9bc22e441d25c26010faac9a41ec1215..a771a7a81334acf10a9063c2185f53628900c52d 100644 (file)
--- a/docs/cmdline-opts/ca-native.md
+++ b/docs/cmdline-opts/ca-native.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: ca-native
-Help: Use CA certificates from the native OS
+Help: Load CA certs from the OS
 Protocols: TLS
 Category: tls
 Added: 8.2.0

diff --git a/docs/cmdline-opts/cert-status.md b/docs/cmdline-opts/cert-status.md
index 6d7b234bf7ad735e7983633e343ee9128128d92d..8b6e57b9edf0d31a370cf2418dbe52960f2453da 100644 (file)
--- a/docs/cmdline-opts/cert-status.md
+++ b/docs/cmdline-opts/cert-status.md
@@ -4,7 +4,7 @@ SPDX-License-Identifier: curl
 Long: cert-status
 Protocols: TLS
 Added: 7.41.0
-Help: Verify the status of the server cert via OCSP-staple
+Help: Verify server cert status OCSP-staple
 Category: tls
 Multi: boolean
 See-also:

diff --git a/docs/cmdline-opts/connect-timeout.md b/docs/cmdline-opts/connect-timeout.md
index f7281b09a94bb834ba3e7c77a62d356790266a40..e1400811e9d98215ea41cd76f41e76c30147f5bb 100644 (file)
--- a/docs/cmdline-opts/connect-timeout.md
+++ b/docs/cmdline-opts/connect-timeout.md
@@ -2,8 +2,8 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: connect-timeout
-Arg: <fractional seconds>
-Help: Maximum time allowed for connection
+Arg: <seconds>
+Help: Maximum time allowed to connect
 Category: connection
 Added: 7.7
 Multi: single

diff --git a/docs/cmdline-opts/cookie-jar.md b/docs/cmdline-opts/cookie-jar.md
index da2ac433281ecd99f4ee29d3c237a5b887468043..f993685916b556f4e17c21782c4409a050ba36fd 100644 (file)
--- a/docs/cmdline-opts/cookie-jar.md
+++ b/docs/cmdline-opts/cookie-jar.md
@@ -5,7 +5,7 @@ Short: c
 Long: cookie-jar
 Arg: <filename>
 Protocols: HTTP
-Help: Write cookies to <filename> after operation
+Help: Save cookies to <filename> after operation
 Category: http
 Added: 7.9
 Multi: single

diff --git a/docs/cmdline-opts/cookie.md b/docs/cmdline-opts/cookie.md
index c61f98215780ab75e5693465e01ea8d84dc4960b..cbc8b84572af374ea460284c74bf2f2d5e398f39 100644 (file)
--- a/docs/cmdline-opts/cookie.md
+++ b/docs/cmdline-opts/cookie.md
@@ -5,7 +5,7 @@ Short: b
 Long: cookie
 Arg: <data|filename>
 Protocols: HTTP
-Help: Send cookies from string/file
+Help: Send cookies from string/load from file
 Category: http
 Added: 4.9
 Multi: append

diff --git a/docs/cmdline-opts/crlfile.md b/docs/cmdline-opts/crlfile.md
index 16bd7b35b98bca691fbf9fd5af904b15b0d7ec73..a762af09f11331be496119dfe5e714e1e12393af 100644 (file)
--- a/docs/cmdline-opts/crlfile.md
+++ b/docs/cmdline-opts/crlfile.md
@@ -4,7 +4,7 @@ SPDX-License-Identifier: curl
 Long: crlfile
 Arg: <file>
 Protocols: TLS
-Help: Use this CRL list
+Help: Certificate Revocation list
 Added: 7.19.7
 Category: tls
 Multi: single

diff --git a/docs/cmdline-opts/curves.md b/docs/cmdline-opts/curves.md
index b701773641fff01dcde4069fa1f812598e4d65a7..9473aeaa7a8a6371deadde6b2548f5d86a5a0a7c 100644 (file)
--- a/docs/cmdline-opts/curves.md
+++ b/docs/cmdline-opts/curves.md
@@ -2,8 +2,8 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: curves
-Arg: <algorithm list>
-Help: (EC) TLS key exchange algorithm(s) to request
+Arg: <list>
+Help: (EC) TLS key exchange algorithms to request
 Protocols: TLS
 Added: 7.73.0
 Category: tls

diff --git a/docs/cmdline-opts/digest.md b/docs/cmdline-opts/digest.md
index 658932a54349ec91c2bda9b8d3e6efebf3c86d72..04c5a79a964fb2b5169775d8040c9565b82fbec3 100644 (file)
--- a/docs/cmdline-opts/digest.md
+++ b/docs/cmdline-opts/digest.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: digest
-Help: Use HTTP Digest Authentication
+Help: HTTP Digest Authentication
 Protocols: HTTP
 Mutexed: basic ntlm negotiate
 Category: proxy auth http

diff --git a/docs/cmdline-opts/doh-cert-status.md b/docs/cmdline-opts/doh-cert-status.md
index efa9da75c157807da933e431d97812e98023682c..920c5b435d5edc5b7d139a6e8e2407640f96d459 100644 (file)
--- a/docs/cmdline-opts/doh-cert-status.md
+++ b/docs/cmdline-opts/doh-cert-status.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: doh-cert-status
-Help: Verify the status of the DoH server cert via OCSP-staple
+Help: Verify DoH server cert status OCSP-staple
 Added: 7.76.0
 Category: dns tls
 Multi: boolean
@@ -15,3 +15,12 @@ Example:
 # `--doh-cert-status`
 
 Same as --cert-status but used for DoH (DNS-over-HTTPS).
+
+Verifies the status of the DoH servers' certificate by using the Certificate
+Status Request (aka. OCSP stapling) TLS extension.
+
+If this option is enabled and the DoH server sends an invalid (e.g. expired)
+response, if the response suggests that the server certificate has been
+revoked, or no response at all is received, the verification fails.
+
+This support is currently only implemented in the OpenSSL and GnuTLS backends.

diff --git a/docs/cmdline-opts/etag-compare.md b/docs/cmdline-opts/etag-compare.md
index a695e55eae4439b52c04458552552ffd659fc2cf..d69cbdf34c4baee828b62306270bf15baea37357 100644 (file)
--- a/docs/cmdline-opts/etag-compare.md
+++ b/docs/cmdline-opts/etag-compare.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: etag-compare
 Arg: <file>
-Help: Pass an ETag from a file as a custom header
+Help: Load ETag from file
 Protocols: HTTP
 Added: 7.68.0
 Category: http
@@ -20,10 +20,8 @@ Example:
 Make a conditional HTTP request for the specific ETag read from the given file
 by sending a custom If-None-Match header using the stored ETag.
 
-For correct results, make sure that the specified file contains only a
-single line with the desired ETag. An empty file is parsed as an empty
-ETag.
+For correct results, make sure that the specified file contains only a single
+line with the desired ETag. An empty file is parsed as an empty ETag.
 
-Use the option --etag-save to first save the ETag from a response, and
-then use this option to compare against the saved ETag in a subsequent
-request.
+Use the option --etag-save to first save the ETag from a response, and then
+use this option to compare against the saved ETag in a subsequent request.

diff --git a/docs/cmdline-opts/etag-save.md b/docs/cmdline-opts/etag-save.md
index d642552ffc56aa282584586b81988c537286fd3a..aa346adad3bb957b13571c87a75d9bfb95465946 100644 (file)
--- a/docs/cmdline-opts/etag-save.md
+++ b/docs/cmdline-opts/etag-save.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: etag-save
 Arg: <file>
-Help: Parse ETag from a request and save it to a file
+Help: Parse incoming ETag and save to a file
 Protocols: HTTP
 Added: 7.68.0
 Category: http

diff --git a/docs/cmdline-opts/fail-early.md b/docs/cmdline-opts/fail-early.md
index 40a2e01261881a4859e96d814e8a14789ce97edf..bb22e14707fccc5338f55ad260ec4af25353054b 100644 (file)
--- a/docs/cmdline-opts/fail-early.md
+++ b/docs/cmdline-opts/fail-early.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: fail-early
-Help: Fail on first transfer error, do not continue
+Help: Fail on first transfer error
 Added: 7.52.0
 Category: curl
 Multi: boolean

diff --git a/docs/cmdline-opts/form-escape.md b/docs/cmdline-opts/form-escape.md
index d2bd0d32b9af872cd1953f508d26b25eb6025ec4..083c29e16ba11e91e218e1f9df0a09d5cd22340b 100644 (file)
--- a/docs/cmdline-opts/form-escape.md
+++ b/docs/cmdline-opts/form-escape.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: form-escape
-Help: Escape multipart form field/filenames using backslash
+Help: Escape form fields using backslash
 Protocols: HTTP
 Added: 7.81.0
 Category: http upload

diff --git a/docs/cmdline-opts/ftp-pasv.md b/docs/cmdline-opts/ftp-pasv.md
index 265a8e4534ca868dbcf456eff59b5ed40ea1aca6..964f9769ae59f9cb6c7da70096326c2752863556 100644 (file)
--- a/docs/cmdline-opts/ftp-pasv.md
+++ b/docs/cmdline-opts/ftp-pasv.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: ftp-pasv
-Help: Use PASV/EPSV instead of PORT
+Help: Send PASV/EPSV instead of PORT
 Protocols: FTP
 Added: 7.11.0
 Category: ftp

diff --git a/docs/cmdline-opts/ftp-port.md b/docs/cmdline-opts/ftp-port.md
index 6ac296e2f1b46e17077c1c0d8c5d6c12191386f1..ff6d41c131f691967329960a81510e0b244f57fb 100644 (file)
--- a/docs/cmdline-opts/ftp-port.md
+++ b/docs/cmdline-opts/ftp-port.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: ftp-port
 Arg: <address>
-Help: Use PORT instead of PASV
+Help: Send PORT instead of PASV
 Short: P
 Protocols: FTP
 Category: ftp

diff --git a/docs/cmdline-opts/ftp-ssl-control.md b/docs/cmdline-opts/ftp-ssl-control.md
index ace1ab29fbd7c408a5f9f51a8fc4ec2b905553a1..a68359a7b635f683aa1ca8fe917d4d8dd11d312d 100644 (file)
--- a/docs/cmdline-opts/ftp-ssl-control.md
+++ b/docs/cmdline-opts/ftp-ssl-control.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: ftp-ssl-control
-Help: Require SSL/TLS for FTP login, clear for transfer
+Help: Require TLS for login, clear for transfer
 Protocols: FTP
 Added: 7.16.0
 Category: ftp tls

diff --git a/docs/cmdline-opts/globoff.md b/docs/cmdline-opts/globoff.md
index 1eca6dd0051e49d83870b4a8be89dd170d6b0569..3c8c341439d344036889d32c19a0efcb6d6fc639 100644 (file)
--- a/docs/cmdline-opts/globoff.md
+++ b/docs/cmdline-opts/globoff.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: globoff
 Short: g
-Help: Disable URL sequences and ranges using {} and []
+Help: Disable URL globbing with {} and []
 Category: curl
 Added: 7.6
 Multi: boolean

diff --git a/docs/cmdline-opts/happy-eyeballs-timeout-ms.md b/docs/cmdline-opts/happy-eyeballs-timeout-ms.md
index 0ee2cd7275ef39ae54f28f65726afc1f9767c964..8370ee92bbe36c13b5db0859c3a50bd1d363b3fe 100644 (file)
--- a/docs/cmdline-opts/happy-eyeballs-timeout-ms.md
+++ b/docs/cmdline-opts/happy-eyeballs-timeout-ms.md
@@ -2,8 +2,8 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: happy-eyeballs-timeout-ms
-Arg: <milliseconds>
-Help: Time for IPv6 before trying IPv4
+Arg: <ms>
+Help: Time for IPv6 before IPv4
 Added: 7.59.0
 Category: connection
 Multi: single

diff --git a/docs/cmdline-opts/haproxy-clientip.md b/docs/cmdline-opts/haproxy-clientip.md
index 470d556f06803a7ab3081c44c4e92ef82696719f..fde085a97695d716adf2041df796f492b953c94e 100644 (file)
--- a/docs/cmdline-opts/haproxy-clientip.md
+++ b/docs/cmdline-opts/haproxy-clientip.md
@@ -2,8 +2,8 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: haproxy-clientip
-Arg: <IP address>
-Help: Sets client IP in HAProxy PROXY protocol v1 header
+Arg: <ip>
+Help: Set address in HAProxy PROXY
 Protocols: HTTP
 Added: 8.2.0
 Category: http proxy

diff --git a/docs/cmdline-opts/hostpubmd5.md b/docs/cmdline-opts/hostpubmd5.md
index 15add357d30d3b4f32313ceb3350fda97bf608b9..7dc873254fc91a67278354059379c9c013ff2a4b 100644 (file)
--- a/docs/cmdline-opts/hostpubmd5.md
+++ b/docs/cmdline-opts/hostpubmd5.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: hostpubmd5
 Arg: <md5>
-Help: Acceptable MD5 hash of the host public key
+Help: Acceptable MD5 hash of host public key
 Protocols: SFTP SCP
 Added: 7.17.1
 Category: sftp scp

diff --git a/docs/cmdline-opts/hostpubsha256.md b/docs/cmdline-opts/hostpubsha256.md
index b1faaf8696479855892548903f98fd73df13e393..8ec080551d89533940ddff0b9c691c25e3f10336 100644 (file)
--- a/docs/cmdline-opts/hostpubsha256.md
+++ b/docs/cmdline-opts/hostpubsha256.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: hostpubsha256
 Arg: <sha256>
-Help: Acceptable SHA256 hash of the host public key
+Help: Acceptable SHA256 hash of host public key
 Protocols: SFTP SCP
 Added: 7.80.0
 Category: sftp scp

diff --git a/docs/cmdline-opts/include.md b/docs/cmdline-opts/include.md
index aedf5da0bb38f37a856604a4a86459590fa9ed5d..c4f6beb81cd3e81720987dcddc292ea4fcca7319 100644 (file)
--- a/docs/cmdline-opts/include.md
+++ b/docs/cmdline-opts/include.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: include
 Short: i
-Help: Include protocol response headers in the output
+Help: Include response headers in output
 Protocols: HTTP FTP
 Category: important verbose
 Added: 4.8

diff --git a/docs/cmdline-opts/libcurl.md b/docs/cmdline-opts/libcurl.md
index 4b3c13d4c6703206346b1fa9ea65dec366a2d943..eeae596d0a5d28eab0544f4408b739a56a921dd4 100644 (file)
--- a/docs/cmdline-opts/libcurl.md
+++ b/docs/cmdline-opts/libcurl.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: libcurl
 Arg: <file>
-Help: Dump libcurl equivalent code of this command line
+Help: Generate libcurl code for this command line
 Added: 7.16.1
 Category: curl
 Multi: single

diff --git a/docs/cmdline-opts/local-port.md b/docs/cmdline-opts/local-port.md
index ef01a7c04ff94c6917fe70d8f0d8309f96d60aff..b8c0d3fda1b7b9ad729ee8e5836fe60bf989c077 100644 (file)
--- a/docs/cmdline-opts/local-port.md
+++ b/docs/cmdline-opts/local-port.md
@@ -2,8 +2,8 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: local-port
-Arg: <num/range>
-Help: Force use of RANGE for local port numbers
+Arg: <range>
+Help: Use a local port number within RANGE
 Added: 7.15.2
 Category: connection
 Multi: single

diff --git a/docs/cmdline-opts/location-trusted.md b/docs/cmdline-opts/location-trusted.md
index 11c1486c97a9d5b01eae4500bb2dc8755c94d111..4f4e7def57a0524fc623ca5cb2b22a301d8c3804 100644 (file)
--- a/docs/cmdline-opts/location-trusted.md
+++ b/docs/cmdline-opts/location-trusted.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: location-trusted
-Help: Like --location, and send auth to other hosts
+Help: Like --location, but send auth to other hosts
 Protocols: HTTP
 Category: http auth
 Added: 7.10.4

diff --git a/docs/cmdline-opts/mail-rcpt-allowfails.md b/docs/cmdline-opts/mail-rcpt-allowfails.md
index 1b670adb0953c6fecdc9b15cfddd3cf5e7bbb1eb..a82948bbc4fe7795b0d2eff01bb437f685b86d24 100644 (file)
--- a/docs/cmdline-opts/mail-rcpt-allowfails.md
+++ b/docs/cmdline-opts/mail-rcpt-allowfails.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: mail-rcpt-allowfails
-Help: Allow RCPT TO command to fail for some recipients
+Help: Allow RCPT TO command to fail
 Protocols: SMTP
 Added: 7.69.0
 Category: smtp

diff --git a/docs/cmdline-opts/max-time.md b/docs/cmdline-opts/max-time.md
index 17938dcf2358e6a770e0edce6a2395bd6c26d149..9102442aa9d145453a9ce6fae8d7fd4a32b5a5d3 100644 (file)
--- a/docs/cmdline-opts/max-time.md
+++ b/docs/cmdline-opts/max-time.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: max-time
 Short: m
-Arg: <fractional seconds>
+Arg: <seconds>
 Help: Maximum time allowed for transfer
 Category: connection
 Added: 4.0

diff --git a/docs/cmdline-opts/ntlm-wb.md b/docs/cmdline-opts/ntlm-wb.md
index bc75dda5be97d013bffcc9d6192a2b7c7ded0b60..c5bcd4bfdc01e514d14ad68b5447adaf6d1ba60c 100644 (file)
--- a/docs/cmdline-opts/ntlm-wb.md
+++ b/docs/cmdline-opts/ntlm-wb.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: ntlm-wb
-Help: Use HTTP NTLM authentication with winbind
+Help: HTTP NTLM authentication with winbind
 Protocols: HTTP
 Category: auth http
 Added: 7.22.0

diff --git a/docs/cmdline-opts/ntlm.md b/docs/cmdline-opts/ntlm.md
index 3faeed7d1249d91fc2e1be899a80be5386d72450..b37716bcaa78ae5124049dffe5a94e27e1805bc9 100644 (file)
--- a/docs/cmdline-opts/ntlm.md
+++ b/docs/cmdline-opts/ntlm.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: ntlm
-Help: Use HTTP NTLM authentication
+Help: HTTP NTLM authentication
 Mutexed: basic negotiate digest anyauth
 Protocols: HTTP
 Requires: TLS

diff --git a/docs/cmdline-opts/post301.md b/docs/cmdline-opts/post301.md
index 93c9c65f0f62b6b585bf2f1cfeaf0392e3b9e997..d9506f7dfe31e7a1402f75aa8b6994c112a1022c 100644 (file)
--- a/docs/cmdline-opts/post301.md
+++ b/docs/cmdline-opts/post301.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: post301
-Help: Do not switch to GET after following a 301
+Help: Do not switch to GET after a 301 redirect
 Protocols: HTTP
 Added: 7.17.1
 Category: http post

diff --git a/docs/cmdline-opts/post302.md b/docs/cmdline-opts/post302.md
index 93578be0cac3e8f6f1c3591a4a054eedbf223132..9b2c2f658d738acdbb1479d4f25733feace47277 100644 (file)
--- a/docs/cmdline-opts/post302.md
+++ b/docs/cmdline-opts/post302.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: post302
-Help: Do not switch to GET after following a 302
+Help: Do not switch to GET after a 302 redirect
 Protocols: HTTP
 Added: 7.19.1
 Category: http post

diff --git a/docs/cmdline-opts/post303.md b/docs/cmdline-opts/post303.md
index 916e88a0b68edfdb12c64eb22320639265587aac..63dc0d7956ba672f29ea522da42ca02ba867c971 100644 (file)
--- a/docs/cmdline-opts/post303.md
+++ b/docs/cmdline-opts/post303.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: post303
-Help: Do not switch to GET after following a 303
+Help: Do not switch to GET after a 303 redirect
 Protocols: HTTP
 Added: 7.26.0
 Category: http post

diff --git a/docs/cmdline-opts/proxy-ca-native.md b/docs/cmdline-opts/proxy-ca-native.md
index 9f09cee0cb9f76ae0a2c9aa1e511cf2587630b11..6158b6cf6f49346dd9de34d78187918bead0f300 100644 (file)
--- a/docs/cmdline-opts/proxy-ca-native.md
+++ b/docs/cmdline-opts/proxy-ca-native.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-ca-native
-Help: Use CA certificates from the native OS for proxy
+Help: Load CA certs from the OS to verify proxy
 Protocols: TLS
 Category: tls
 Added: 8.2.0

diff --git a/docs/cmdline-opts/proxy-cacert.md b/docs/cmdline-opts/proxy-cacert.md
index b3a038a591f086c354ff556a5a8e4e54b867ccfd..ec0dd9f1432d5bdd2ba0e7331ff75381eb09a1c3 100644 (file)
--- a/docs/cmdline-opts/proxy-cacert.md
+++ b/docs/cmdline-opts/proxy-cacert.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-cacert
-Help: CA certificate to verify peer against for proxy
+Help: CA certificates to verify proxy against
 Arg: <file>
 Added: 7.52.0
 Category: proxy tls

diff --git a/docs/cmdline-opts/proxy-capath.md b/docs/cmdline-opts/proxy-capath.md
index 62a25a0df555b63bd7bfa86b29f29af45aa8206d..bc2c7b56f59218e4e5c2a973d09c5a6d9004a5c1 100644 (file)
--- a/docs/cmdline-opts/proxy-capath.md
+++ b/docs/cmdline-opts/proxy-capath.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-capath
-Help: CA directory to verify peer against for proxy
+Help: CA directory to verify proxy against
 Arg: <dir>
 Added: 7.52.0
 Category: proxy tls
@@ -18,3 +18,13 @@ Example:
 # `--proxy-capath`
 
 Same as --capath but used in HTTPS proxy context.
+
+Use the specified certificate directory to verify the proxy. Multiple paths
+can be provided by separated with colon (`:`) (e.g. `path1:path2:path3`). The
+certificates must be in PEM format, and if curl is built against OpenSSL, the
+directory must have been processed using the c_rehash utility supplied with
+OpenSSL. Using --proxy-capath can allow OpenSSL-powered curl to make
+SSL-connections much more efficiently than using --proxy-cacert if the
+--proxy-cacert file contains many CA certificates.
+
+If this option is set, the default capath value is ignored.

diff --git a/docs/cmdline-opts/proxy-digest.md b/docs/cmdline-opts/proxy-digest.md
index 4822c79bd7b2af2e8c8807bd065c417878c82e73..77b88d7e4bdace6f2fa54f200bcfbb5709743b83 100644 (file)
--- a/docs/cmdline-opts/proxy-digest.md
+++ b/docs/cmdline-opts/proxy-digest.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-digest
-Help: Use Digest authentication on the proxy
+Help: Digest auth with the proxy
 Category: proxy tls
 Added: 7.12.0
 Multi: mutex

diff --git a/docs/cmdline-opts/proxy-insecure.md b/docs/cmdline-opts/proxy-insecure.md
index 3e174428a9192b8770b0badb7f9798200720b2f0..5796c36237d515e7660616392f3188a431290038 100644 (file)
--- a/docs/cmdline-opts/proxy-insecure.md
+++ b/docs/cmdline-opts/proxy-insecure.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-insecure
-Help: Do HTTPS proxy connections without verifying the proxy
+Help: Skip HTTPS proxy cert verification
 Added: 7.52.0
 Category: proxy tls
 Multi: boolean
@@ -16,3 +16,15 @@ Example:
 # `--proxy-insecure`
 
 Same as --insecure but used in HTTPS proxy context.
+
+Every secure connection curl makes is verified to be secure before the
+transfer takes place. This option makes curl skip the verification step with a
+proxy and proceed without checking.
+
+When this option is not used for a proxy using HTTPS, curl verifies the
+proxy's TLS certificate before it continues: that the certificate contains the
+right name which matches the hostname and that the certificate has been signed
+by a CA certificate present in the cert store. See this online resource for
+further details: **https://curl.se/docs/sslcerts.html**
+
+**WARNING**: using this option makes the transfer to the proxy insecure.

diff --git a/docs/cmdline-opts/proxy-negotiate.md b/docs/cmdline-opts/proxy-negotiate.md
index 33ab1f99ae20bb64d54ed303829bae1a55a9077b..9bedf5dc4aa35cbc25c608c8b1bcd3034749d31d 100644 (file)
--- a/docs/cmdline-opts/proxy-negotiate.md
+++ b/docs/cmdline-opts/proxy-negotiate.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-negotiate
-Help: Use HTTP Negotiate (SPNEGO) authentication on the proxy
+Help: HTTP Negotiate (SPNEGO) auth with the proxy
 Added: 7.17.1
 Category: proxy auth
 Multi: mutex

diff --git a/docs/cmdline-opts/proxy-ntlm.md b/docs/cmdline-opts/proxy-ntlm.md
index 5e772cd6a1bc21253363f9abc79970f2297f0d62..f8375a620e526beba961279e437e4490b15c4a0f 100644 (file)
--- a/docs/cmdline-opts/proxy-ntlm.md
+++ b/docs/cmdline-opts/proxy-ntlm.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-ntlm
-Help: Use NTLM authentication on the proxy
+Help: NTLM authentication with the proxy
 Category: proxy auth
 Added: 7.10.7
 Multi: mutex

diff --git a/docs/cmdline-opts/proxy-ssl-auto-client-cert.md b/docs/cmdline-opts/proxy-ssl-auto-client-cert.md
index f3e77158d1e5debbd0ab5c9f8c5e507f104fb689..578a7a6417cd2dbe6311b94acd5f783575e6ca9f 100644 (file)
--- a/docs/cmdline-opts/proxy-ssl-auto-client-cert.md
+++ b/docs/cmdline-opts/proxy-ssl-auto-client-cert.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-ssl-auto-client-cert
-Help: Use auto client certificate for proxy (Schannel)
+Help: Auto client certificate for proxy
 Added: 7.77.0
 Category: proxy tls
 Multi: boolean
@@ -16,3 +16,5 @@ Example:
 # `--proxy-ssl-auto-client-cert`
 
 Same as --ssl-auto-client-cert but used in HTTPS proxy context.
+
+This is only supported by Schannel.

diff --git a/docs/cmdline-opts/proxy-tlsv1.md b/docs/cmdline-opts/proxy-tlsv1.md
index b7b09ee473bf00b2bc754d0609cd99cd2ef63e8d..0dda72f4b69ba2558501644670966d5371dae88c 100644 (file)
--- a/docs/cmdline-opts/proxy-tlsv1.md
+++ b/docs/cmdline-opts/proxy-tlsv1.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxy-tlsv1
-Help: Use TLSv1 for HTTPS proxy
+Help: TLSv1 for HTTPS proxy
 Added: 7.52.0
 Category: proxy tls auth
 Multi: mutex

diff --git a/docs/cmdline-opts/proxytunnel.md b/docs/cmdline-opts/proxytunnel.md
index 74faa681a911adc6006297f0819a19071da57cc8..169d2ad8bc4330be10c6f27bf18684003a9f290c 100644 (file)
--- a/docs/cmdline-opts/proxytunnel.md
+++ b/docs/cmdline-opts/proxytunnel.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: proxytunnel
 Short: p
-Help: Operate through an HTTP proxy tunnel (using CONNECT)
+Help: HTTP proxy tunnel (using CONNECT)
 Category: proxy
 Added: 7.3
 Multi: boolean

diff --git a/docs/cmdline-opts/remote-name.md b/docs/cmdline-opts/remote-name.md
index 487799fafc94815b02dde2c5158819206b8608de..5d2fcdcb2b676de491e28a6c26de6010c0dd897f 100644 (file)
--- a/docs/cmdline-opts/remote-name.md
+++ b/docs/cmdline-opts/remote-name.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: remote-name
 Short: O
-Help: Write output to a file named as the remote file
+Help: Write output to file named as remote file
 Category: important output
 Added: 4.0
 Multi: append

diff --git a/docs/cmdline-opts/remote-time.md b/docs/cmdline-opts/remote-time.md
index b010bc1308c70d52a629c58c3fe1f41f06721fd8..7c5d21f036751d5c775ca2c4cd513fdcd326078f 100644 (file)
--- a/docs/cmdline-opts/remote-time.md
+++ b/docs/cmdline-opts/remote-time.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: remote-time
 Short: R
-Help: Set the remote file's time on the local output
+Help: Set remote file's time on local output
 Category: output
 Added: 7.9
 Multi: boolean

diff --git a/docs/cmdline-opts/resolve.md b/docs/cmdline-opts/resolve.md
index 6e0d393f54aa90e0ea6dd3167814b1bdcdcdd48e..ca1f930fcd2f532886728f96b62771a36db01373 100644 (file)
--- a/docs/cmdline-opts/resolve.md
+++ b/docs/cmdline-opts/resolve.md
@@ -3,7 +3,7 @@ c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: resolve
 Arg: <[+]host:port:addr[,addr]...>
-Help: Resolve the host+port to this address
+Help: Resolve host+port to address
 Added: 7.21.3
 Category: connection dns
 Multi: append

diff --git a/docs/cmdline-opts/retry-all-errors.md b/docs/cmdline-opts/retry-all-errors.md
index 6d3deebc76cb95b7ed7c007b5d7c35326d2f07cd..230e730678eeb06e5fb1966e2e530f644a3cbafa 100644 (file)
--- a/docs/cmdline-opts/retry-all-errors.md
+++ b/docs/cmdline-opts/retry-all-errors.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: retry-all-errors
-Help: Retry all errors (use with --retry)
+Help: Retry all errors (with --retry)
 Added: 7.71.0
 Category: curl
 Multi: boolean

diff --git a/docs/cmdline-opts/retry-connrefused.md b/docs/cmdline-opts/retry-connrefused.md
index 975dc097a70b5945dfe85db083a05637aa036812..22345cd8818eaf19c8a07956f5097d913867c294 100644 (file)
--- a/docs/cmdline-opts/retry-connrefused.md
+++ b/docs/cmdline-opts/retry-connrefused.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: retry-connrefused
-Help: Retry on connection refused (use with --retry)
+Help: Retry on connection refused (with --retry)
 Added: 7.52.0
 Category: curl
 Multi: boolean

diff --git a/docs/cmdline-opts/sasl-ir.md b/docs/cmdline-opts/sasl-ir.md
index 56732807d4810c62d4356d603e64722a35302135..b11137df0a63a8bfd679128d60131c78330f7fbb 100644 (file)
--- a/docs/cmdline-opts/sasl-ir.md
+++ b/docs/cmdline-opts/sasl-ir.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: sasl-ir
-Help: Enable initial response in SASL authentication
+Help: Initial response in SASL authentication
 Added: 7.31.0
 Category: auth
 Multi: boolean

diff --git a/docs/cmdline-opts/socks5-basic.md b/docs/cmdline-opts/socks5-basic.md
index ec80fa9edc974d8b68445aac4b85aeb988d04981..dc2a5532f11c56c0632d63749f6f2211beba19c0 100644 (file)
--- a/docs/cmdline-opts/socks5-basic.md
+++ b/docs/cmdline-opts/socks5-basic.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: socks5-basic
-Help: Enable username/password auth for SOCKS5 proxies
+Help: Username/password auth for SOCKS5 proxies
 Added: 7.55.0
 Category: proxy auth
 Multi: mutex

diff --git a/docs/cmdline-opts/ssl-revoke-best-effort.md b/docs/cmdline-opts/ssl-revoke-best-effort.md
index 994e1f654c59c0a74a6425c40d304785cc06f27f..0257e05f47e677a3f3e8e4457c2fac3c7d0e26f3 100644 (file)
--- a/docs/cmdline-opts/ssl-revoke-best-effort.md
+++ b/docs/cmdline-opts/ssl-revoke-best-effort.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: ssl-revoke-best-effort
-Help: Ignore missing/offline cert CRL dist points (Schannel)
+Help: Ignore missing cert CRL dist points
 Added: 7.70.0
 Protocols: TLS
 Category: tls

diff --git a/docs/cmdline-opts/ssl.md b/docs/cmdline-opts/ssl.md
index 9a78ae3a26eb69e8c5a93bddf46d82f4f4a26d4e..73fa96ad641088c84e78c9e93c8710071ca4ef0d 100644 (file)
--- a/docs/cmdline-opts/ssl.md
+++ b/docs/cmdline-opts/ssl.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: ssl
-Help: Try SSL/TLS
+Help: Try enabling TLS
 Protocols: FTP IMAP POP3 SMTP LDAP
 Added: 7.20.0
 Category: tls

diff --git a/docs/cmdline-opts/sslv2.md b/docs/cmdline-opts/sslv2.md
index 05fe938bab325ae47593fe5e96e205fc18f047b4..3bd36f02cd455668c74cb1cc1d6e4ae546454121 100644 (file)
--- a/docs/cmdline-opts/sslv2.md
+++ b/docs/cmdline-opts/sslv2.md
@@ -8,7 +8,7 @@ Protocols: SSL
 Added: 5.9
 Mutexed: sslv3 tlsv1 tlsv1.1 tlsv1.2
 Requires: TLS
-Help: Use SSLv2
+Help: SSLv2
 Category: tls
 Multi: mutex
 See-also:

diff --git a/docs/cmdline-opts/sslv3.md b/docs/cmdline-opts/sslv3.md
index 343f628a5f9e930d2ad3e0538ab8e5ab57957bc4..32d4c1206690ca83ec73713747fd64d1f1eaa474 100644 (file)
--- a/docs/cmdline-opts/sslv3.md
+++ b/docs/cmdline-opts/sslv3.md
@@ -8,7 +8,7 @@ Protocols: SSL
 Added: 5.9
 Mutexed: sslv2 tlsv1 tlsv1.1 tlsv1.2
 Requires: TLS
-Help: Use SSLv3
+Help: SSLv3
 Category: tls
 Multi: mutex
 See-also:

diff --git a/docs/cmdline-opts/tcp-nodelay.md b/docs/cmdline-opts/tcp-nodelay.md
index 9a6df8d62cc3356c8663a8e9bccfd4d3e014625c..6944d70142b2243771865e1ad7dcee5d1806e6b1 100644 (file)
--- a/docs/cmdline-opts/tcp-nodelay.md
+++ b/docs/cmdline-opts/tcp-nodelay.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: tcp-nodelay
-Help: Use the TCP_NODELAY option
+Help: Set TCP_NODELAY
 Added: 7.11.2
 Category: connection
 Multi: boolean

diff --git a/docs/cmdline-opts/tls-max.md b/docs/cmdline-opts/tls-max.md
index a815d21d6bf1eb9090b427cbd17c13efe0615ef6..87233c75ac05c9caf97e0e1d536b4348693b8457 100644 (file)
--- a/docs/cmdline-opts/tls-max.md
+++ b/docs/cmdline-opts/tls-max.md
@@ -7,7 +7,7 @@ Tags: Versions
 Protocols: TLS
 Added: 7.54.0
 Requires: TLS
-Help: Set maximum allowed TLS version
+Help: Maximum allowed TLS version
 Category: tls
 Multi: single
 See-also:

diff --git a/docs/cmdline-opts/tls13-ciphers.md b/docs/cmdline-opts/tls13-ciphers.md
index 2f68a6195bd3a29ffdb9dc16dffc9a704dba264b..55145aacf9cd6470ea7e37a266f173c4a627adc6 100644 (file)
--- a/docs/cmdline-opts/tls13-ciphers.md
+++ b/docs/cmdline-opts/tls13-ciphers.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: tls13-ciphers
-Arg: <ciphersuite list>
+Arg: <list>
 help: TLS 1.3 cipher suites to use
 Protocols: TLS
 Category: tls

diff --git a/docs/cmdline-opts/tlsv1.0.md b/docs/cmdline-opts/tlsv1.0.md
index 01aa0aea0d67a72f164a9199957449e11e16b18f..66ca32389ef0d6404f49473ed8ae0a841a069831 100644 (file)
--- a/docs/cmdline-opts/tlsv1.0.md
+++ b/docs/cmdline-opts/tlsv1.0.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: tlsv1.0
-Help: Use TLSv1.0 or greater
+Help: TLSv1.0 or greater
 Protocols: TLS
 Added: 7.34.0
 Category: tls

diff --git a/docs/cmdline-opts/tlsv1.1.md b/docs/cmdline-opts/tlsv1.1.md
index b0d17838c872b7c5263d78817b847abf29da9b89..577b7c7a5011adc1cfafcaa39d8fb6482a148828 100644 (file)
--- a/docs/cmdline-opts/tlsv1.1.md
+++ b/docs/cmdline-opts/tlsv1.1.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: tlsv1.1
-Help: Use TLSv1.1 or greater
+Help: TLSv1.1 or greater
 Protocols: TLS
 Added: 7.34.0
 Category: tls

diff --git a/docs/cmdline-opts/tlsv1.2.md b/docs/cmdline-opts/tlsv1.2.md
index b39c9abcafab7bfe5e419123d585a729364281c8..0132074e3c22fa9e7a139ad9e6e3ab980ef5c87c 100644 (file)
--- a/docs/cmdline-opts/tlsv1.2.md
+++ b/docs/cmdline-opts/tlsv1.2.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: tlsv1.2
-Help: Use TLSv1.2 or greater
+Help: TLSv1.2 or greater
 Protocols: TLS
 Added: 7.34.0
 Category: tls

diff --git a/docs/cmdline-opts/tlsv1.3.md b/docs/cmdline-opts/tlsv1.3.md
index 537b372a1c47a37e95d0d72110bbcd0cfefc6481..6c65f59de656a7014654d44b7c550587de4872f6 100644 (file)
--- a/docs/cmdline-opts/tlsv1.3.md
+++ b/docs/cmdline-opts/tlsv1.3.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: tlsv1.3
-Help: Use TLSv1.3 or greater
+Help: TLSv1.3 or greater
 Protocols: TLS
 Added: 7.52.0
 Category: tls

diff --git a/docs/cmdline-opts/tlsv1.md b/docs/cmdline-opts/tlsv1.md
index a3960e53edca680d043b08e54216eb934f8b58bf..c6fc9e9230b31853f235e275d29e9b8088bc2912 100644 (file)
--- a/docs/cmdline-opts/tlsv1.md
+++ b/docs/cmdline-opts/tlsv1.md
@@ -8,7 +8,7 @@ Protocols: TLS
 Added: 7.9.2
 Mutexed: tlsv1.1 tlsv1.2 tlsv1.3
 Requires: TLS
-Help: Use TLSv1.0 or greater
+Help: TLSv1.0 or greater
 Category: tls
 Multi: mutex
 See-also:

diff --git a/docs/cmdline-opts/trace-ids.md b/docs/cmdline-opts/trace-ids.md
index 43774d37204a1a8c9b6556913705c66c9f715b7e..bf54ecb3427bbf7b1273b5970bd572c26539fa6f 100644 (file)
--- a/docs/cmdline-opts/trace-ids.md
+++ b/docs/cmdline-opts/trace-ids.md
@@ -2,7 +2,7 @@
 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
 SPDX-License-Identifier: curl
 Long: trace-ids
-Help: Add transfer and connection identifiers to trace/verbose output
+Help: Transfer + connection ids in verbose output
 Added: 8.2.0
 Category: verbose
 Multi: boolean

diff --git a/docs/cmdline-opts/write-out.md b/docs/cmdline-opts/write-out.md
index 6a75efeaee7f75824c514b1e3bb1f9cca4c5e42a..bb1422c99e3689f8768ab4b66659be8a7238be5b 100644 (file)
--- a/docs/cmdline-opts/write-out.md
+++ b/docs/cmdline-opts/write-out.md
@@ -4,7 +4,7 @@ SPDX-License-Identifier: curl
 Long: write-out
 Short: w
 Arg: <format>
-Help: Use output FORMAT after completion
+Help: Output FORMAT after completion
 Category: verbose
 Added: 6.5
 Multi: single

diff --git a/src/tool_help.c b/src/tool_help.c
index 04ac245370758b38406f24d0755cb2bde225d8fe..26ceea3dd1a8dd03daf90d645d345005df86b63d 100644 (file)
--- a/src/tool_help.c
+++ b/src/tool_help.c
@@ -73,6 +73,11 @@ static const struct category_descriptors categories[] = {
   {NULL, NULL, CURLHELP_HIDDEN}
 };
 
+#ifdef _WIN32
+#define BORDER 78
+#else
+#define BORDER 79
+#endif
 
 static void print_category(curlhelp_t category)
 {
@@ -91,12 +96,21 @@ static void print_category(curlhelp_t category)
     if(len > longdesc)
       longdesc = len;
   }
-  if(longopt + longdesc > 80)
-    longopt = 80 - longdesc;
-
+  if(longopt + longdesc >= BORDER) {
+    longdesc -= 3;
+    longopt = BORDER -1 - longdesc;
+  }
   for(i = 0; helptext[i].opt; ++i)
     if(helptext[i].categories & category) {
-      printf(" %-*s %s\n", (int)longopt, helptext[i].opt, helptext[i].desc);
+      int opt = (int)longopt;
+      size_t desclen = strlen(helptext[i].desc);
+      if(opt + desclen >= (BORDER -1)) {
+        if(desclen < (BORDER -1))
+          opt = (BORDER -2) - (int)desclen;
+        else
+          opt = 0;
+      }
+      printf(" %-*s  %s\n", opt, helptext[i].opt, helptext[i].desc);
     }
 }
 

diff --git a/src/tool_listhelp.c b/src/tool_listhelp.c
index f2feb27185c0548f98528ae697f4044db5ed1a97..5d9364405448bf33854b47dcd9f3c0746d6ff991 100644 (file)
--- a/src/tool_listhelp.c
+++ b/src/tool_listhelp.c
@@ -45,14 +45,14 @@ const struct helptxt helptext[] = {
   {"-a, --append",
    "Append to target file when uploading",
    CURLHELP_FTP | CURLHELP_SFTP},
-  {"    --aws-sigv4 <provider1[:provider2[:region[:service]]]>",
-   "Use AWS V4 signature authentication",
+  {"    --aws-sigv4 <provider1[:prvdr2[:reg[:srv]]]>",
+   "AWS V4 signature auth",
    CURLHELP_AUTH | CURLHELP_HTTP},
   {"    --basic",
-   "Use HTTP Basic Authentication",
+   "HTTP Basic Authentication",
    CURLHELP_AUTH},
   {"    --ca-native",
-   "Use CA certificates from the native OS",
+   "Load CA certs from the OS",
    CURLHELP_TLS},
   {"    --cacert <file>",
    "CA certificate to verify peer against",
@@ -64,7 +64,7 @@ const struct helptxt helptext[] = {
    "Client certificate file and password",
    CURLHELP_TLS},
   {"    --cert-status",
-   "Verify the status of the server cert via OCSP-staple",
+   "Verify server cert status OCSP-staple",
    CURLHELP_TLS},
   {"    --cert-type <type>",
    "Certificate type (DER/PEM/ENG/P12)",
@@ -81,8 +81,8 @@ const struct helptxt helptext[] = {
   {"-K, --config <file>",
    "Read config from a file",
    CURLHELP_CURL},
-  {"    --connect-timeout <fractional seconds>",
-   "Maximum time allowed for connection",
+  {"    --connect-timeout <seconds>",
+   "Maximum time allowed to connect",
    CURLHELP_CONNECTION},
   {"    --connect-to <HOST1:PORT1:HOST2:PORT2>",
    "Connect to host",
@@ -91,10 +91,10 @@ const struct helptxt helptext[] = {
    "Resumed transfer offset",
    CURLHELP_CONNECTION},
   {"-b, --cookie <data|filename>",
-   "Send cookies from string/file",
+   "Send cookies from string/load from file",
    CURLHELP_HTTP},
   {"-c, --cookie-jar <filename>",
-   "Write cookies to <filename> after operation",
+   "Save cookies to <filename> after operation",
    CURLHELP_HTTP},
   {"    --create-dirs",
    "Create necessary local directory hierarchy",
@@ -106,10 +106,10 @@ const struct helptxt helptext[] = {
    "Convert LF to CRLF in upload",
    CURLHELP_FTP | CURLHELP_SMTP},
   {"    --crlfile <file>",
-   "Use this CRL list",
+   "Certificate Revocation list",
    CURLHELP_TLS},
-  {"    --curves <algorithm list>",
-   "(EC) TLS key exchange algorithm(s) to request",
+  {"    --curves <list>",
+   "(EC) TLS key exchange algorithms to request",
    CURLHELP_TLS},
   {"-d, --data <data>",
    "HTTP POST data",
@@ -130,7 +130,7 @@ const struct helptxt helptext[] = {
    "GSS-API delegation permission",
    CURLHELP_AUTH},
   {"    --digest",
-   "Use HTTP Digest Authentication",
+   "HTTP Digest Authentication",
    CURLHELP_PROXY | CURLHELP_AUTH | CURLHELP_HTTP},
   {"-q, --disable",
    "Disable .curlrc",
@@ -157,7 +157,7 @@ const struct helptxt helptext[] = {
    "DNS server addrs to use",
    CURLHELP_DNS},
   {"    --doh-cert-status",
-   "Verify the status of the DoH server cert via OCSP-staple",
+   "Verify DoH server cert status OCSP-staple",
    CURLHELP_DNS | CURLHELP_TLS},
   {"    --doh-insecure",
    "Allow insecure DoH server connections",
@@ -175,10 +175,10 @@ const struct helptxt helptext[] = {
    "Crypto engine to use",
    CURLHELP_TLS},
   {"    --etag-compare <file>",
-   "Pass an ETag from a file as a custom header",
+   "Load ETag from file",
    CURLHELP_HTTP},
   {"    --etag-save <file>",
-   "Parse ETag from a request and save it to a file",
+   "Parse incoming ETag and save to a file",
    CURLHELP_HTTP},
   {"    --expect100-timeout <seconds>",
    "How long to wait for 100-continue",
@@ -187,7 +187,7 @@ const struct helptxt helptext[] = {
    "Fail fast with no output on HTTP errors",
    CURLHELP_IMPORTANT | CURLHELP_HTTP},
   {"    --fail-early",
-   "Fail on first transfer error, do not continue",
+   "Fail on first transfer error",
    CURLHELP_CURL},
   {"    --fail-with-body",
    "Fail on HTTP errors but save the body",
@@ -199,7 +199,7 @@ const struct helptxt helptext[] = {
    "Specify multipart MIME data",
    CURLHELP_HTTP | CURLHELP_UPLOAD},
   {"    --form-escape",
-   "Escape multipart form field/filenames using backslash",
+   "Escape form fields using backslash",
    CURLHELP_HTTP | CURLHELP_UPLOAD},
   {"    --form-string <name=string>",
    "Specify multipart MIME data",
@@ -217,10 +217,10 @@ const struct helptxt helptext[] = {
    "Control CWD usage",
    CURLHELP_FTP},
   {"    --ftp-pasv",
-   "Use PASV/EPSV instead of PORT",
+   "Send PASV/EPSV instead of PORT",
    CURLHELP_FTP},
   {"-P, --ftp-port <address>",
-   "Use PORT instead of PASV",
+   "Send PORT instead of PASV",
    CURLHELP_FTP},
   {"    --ftp-pret",
    "Send PRET before PASV",
@@ -235,19 +235,19 @@ const struct helptxt helptext[] = {
    "Set CCC mode",
    CURLHELP_FTP | CURLHELP_TLS},
   {"    --ftp-ssl-control",
-   "Require SSL/TLS for FTP login, clear for transfer",
+   "Require TLS for login, clear for transfer",
    CURLHELP_FTP | CURLHELP_TLS},
   {"-G, --get",
    "Put the post data in the URL and use GET",
    CURLHELP_HTTP | CURLHELP_UPLOAD},
   {"-g, --globoff",
-   "Disable URL sequences and ranges using {} and []",
+   "Disable URL globbing with {} and []",
    CURLHELP_CURL},
-  {"    --happy-eyeballs-timeout-ms <milliseconds>",
-   "Time for IPv6 before trying IPv4",
+  {"    --happy-eyeballs-timeout-ms <ms>",
+   "Time for IPv6 before IPv4",
    CURLHELP_CONNECTION},
-  {"    --haproxy-clientip <IP address>",
-   "Sets client IP in HAProxy PROXY protocol v1 header",
+  {"    --haproxy-clientip <ip>",
+   "Set address in HAProxy PROXY",
    CURLHELP_HTTP | CURLHELP_PROXY},
   {"    --haproxy-protocol",
    "Send HAProxy PROXY protocol v1 header",
@@ -262,10 +262,10 @@ const struct helptxt helptext[] = {
    "Get help for commands",
    CURLHELP_IMPORTANT | CURLHELP_CURL},
   {"    --hostpubmd5 <md5>",
-   "Acceptable MD5 hash of the host public key",
+   "Acceptable MD5 hash of host public key",
    CURLHELP_SFTP | CURLHELP_SCP},
   {"    --hostpubsha256 <sha256>",
-   "Acceptable SHA256 hash of the host public key",
+   "Acceptable SHA256 hash of host public key",
    CURLHELP_SFTP | CURLHELP_SCP},
   {"    --hsts <filename>",
    "Enable HSTS with this cache file",
@@ -295,7 +295,7 @@ const struct helptxt helptext[] = {
    "Ignore the size of the remote resource",
    CURLHELP_HTTP | CURLHELP_FTP},
   {"-i, --include",
-   "Include protocol response headers in the output",
+   "Include response headers in output",
    CURLHELP_IMPORTANT | CURLHELP_VERBOSE},
   {"-k, --insecure",
    "Allow insecure server connections",
@@ -331,7 +331,7 @@ const struct helptxt helptext[] = {
    "Enable Kerberos with security <level>",
    CURLHELP_FTP},
   {"    --libcurl <file>",
-   "Dump libcurl equivalent code of this command line",
+   "Generate libcurl code for this command line",
    CURLHELP_CURL},
   {"    --limit-rate <speed>",
    "Limit transfer speed to RATE",
@@ -339,14 +339,14 @@ const struct helptxt helptext[] = {
   {"-l, --list-only",
    "List only mode",
    CURLHELP_FTP | CURLHELP_POP3 | CURLHELP_SFTP},
-  {"    --local-port <num/range>",
-   "Force use of RANGE for local port numbers",
+  {"    --local-port <range>",
+   "Use a local port number within RANGE",
    CURLHELP_CONNECTION},
   {"-L, --location",
    "Follow redirects",
    CURLHELP_HTTP},
   {"    --location-trusted",
-   "Like --location, and send auth to other hosts",
+   "Like --location, but send auth to other hosts",
    CURLHELP_HTTP | CURLHELP_AUTH},
   {"    --login-options <options>",
    "Server login options",
@@ -361,7 +361,7 @@ const struct helptxt helptext[] = {
    "Mail to this address",
    CURLHELP_SMTP},
   {"    --mail-rcpt-allowfails",
-   "Allow RCPT TO command to fail for some recipients",
+   "Allow RCPT TO command to fail",
    CURLHELP_SMTP},
   {"-M, --manual",
    "Display the full manual",
@@ -372,7 +372,7 @@ const struct helptxt helptext[] = {
   {"    --max-redirs <num>",
    "Maximum number of redirects allowed",
    CURLHELP_HTTP},
-  {"-m, --max-time <fractional seconds>",
+  {"-m, --max-time <seconds>",
    "Maximum time allowed for transfer",
    CURLHELP_CONNECTION},
   {"    --metalink",
@@ -418,10 +418,10 @@ const struct helptxt helptext[] = {
    "List of hosts which do not use proxy",
    CURLHELP_PROXY},
   {"    --ntlm",
-   "Use HTTP NTLM authentication",
+   "HTTP NTLM authentication",
    CURLHELP_AUTH | CURLHELP_HTTP},
   {"    --ntlm-wb",
-   "Use HTTP NTLM authentication with winbind",
+   "HTTP NTLM authentication with winbind",
    CURLHELP_AUTH | CURLHELP_HTTP},
   {"    --oauth2-bearer <token>",
    "OAuth 2 Bearer Token",
@@ -451,13 +451,13 @@ const struct helptxt helptext[] = {
    "FILE/HASHES Public key to verify peer against",
    CURLHELP_TLS},
   {"    --post301",
-   "Do not switch to GET after following a 301",
+   "Do not switch to GET after a 301 redirect",
    CURLHELP_HTTP | CURLHELP_POST},
   {"    --post302",
-   "Do not switch to GET after following a 302",
+   "Do not switch to GET after a 302 redirect",
    CURLHELP_HTTP | CURLHELP_POST},
   {"    --post303",
-   "Do not switch to GET after following a 303",
+   "Do not switch to GET after a 303 redirect",
    CURLHELP_HTTP | CURLHELP_POST},
   {"    --preproxy [protocol://]host[:port]",
    "Use this proxy first",
@@ -484,13 +484,13 @@ const struct helptxt helptext[] = {
    "Use Basic authentication on the proxy",
    CURLHELP_PROXY | CURLHELP_AUTH},
   {"    --proxy-ca-native",
-   "Use CA certificates from the native OS for proxy",
+   "Load CA certs from the OS to verify proxy",
    CURLHELP_TLS},
   {"    --proxy-cacert <file>",
-   "CA certificate to verify peer against for proxy",
+   "CA certificates to verify proxy against",
    CURLHELP_PROXY | CURLHELP_TLS},
   {"    --proxy-capath <dir>",
-   "CA directory to verify peer against for proxy",
+   "CA directory to verify proxy against",
    CURLHELP_PROXY | CURLHELP_TLS},
   {"    --proxy-cert <cert[:passwd]>",
    "Set client certificate for proxy",
@@ -505,7 +505,7 @@ const struct helptxt helptext[] = {
    "Set a CRL list for proxy",
    CURLHELP_PROXY | CURLHELP_TLS},
   {"    --proxy-digest",
-   "Use Digest authentication on the proxy",
+   "Digest auth with the proxy",
    CURLHELP_PROXY | CURLHELP_TLS},
   {"    --proxy-header <header/@file>",
    "Pass custom header(s) to proxy",
@@ -514,7 +514,7 @@ const struct helptxt helptext[] = {
    "Use HTTP/2 with HTTPS proxy",
    CURLHELP_HTTP | CURLHELP_PROXY},
   {"    --proxy-insecure",
-   "Do HTTPS proxy connections without verifying the proxy",
+   "Skip HTTPS proxy cert verification",
    CURLHELP_PROXY | CURLHELP_TLS},
   {"    --proxy-key <key>",
    "Private key for HTTPS proxy",
@@ -523,10 +523,10 @@ const struct helptxt helptext[] = {
    "Private key file type for proxy",
    CURLHELP_PROXY | CURLHELP_TLS},
   {"    --proxy-negotiate",
-   "Use HTTP Negotiate (SPNEGO) authentication on the proxy",
+   "HTTP Negotiate (SPNEGO) auth with the proxy",
    CURLHELP_PROXY | CURLHELP_AUTH},
   {"    --proxy-ntlm",
-   "Use NTLM authentication on the proxy",
+   "NTLM authentication with the proxy",
    CURLHELP_PROXY | CURLHELP_AUTH},
   {"    --proxy-pass <phrase>",
    "Pass phrase for the private key for HTTPS proxy",
@@ -541,7 +541,7 @@ const struct helptxt helptext[] = {
    "Allow security flaw for interop for HTTPS proxy",
    CURLHELP_PROXY | CURLHELP_TLS},
   {"    --proxy-ssl-auto-client-cert",
-   "Use auto client certificate for proxy (Schannel)",
+   "Auto client certificate for proxy",
    CURLHELP_PROXY | CURLHELP_TLS},
   {"    --proxy-tls13-ciphers <ciphersuite list>",
    "TLS 1.3 proxy cipher suites",
@@ -556,7 +556,7 @@ const struct helptxt helptext[] = {
    "TLS username for HTTPS proxy",
    CURLHELP_PROXY | CURLHELP_TLS | CURLHELP_AUTH},
   {"    --proxy-tlsv1",
-   "Use TLSv1 for HTTPS proxy",
+   "TLSv1 for HTTPS proxy",
    CURLHELP_PROXY | CURLHELP_TLS | CURLHELP_AUTH},
   {"-U, --proxy-user <user:password>",
    "Proxy user and password",
@@ -565,7 +565,7 @@ const struct helptxt helptext[] = {
    "Use HTTP/1.0 proxy on given port",
    CURLHELP_PROXY},
   {"-p, --proxytunnel",
-   "Operate through an HTTP proxy tunnel (using CONNECT)",
+   "HTTP proxy tunnel (using CONNECT)",
    CURLHELP_PROXY},
   {"    --pubkey <key>",
    "SSH Public key filename",
@@ -592,13 +592,13 @@ const struct helptxt helptext[] = {
    "Use the header-provided filename",
    CURLHELP_OUTPUT},
   {"-O, --remote-name",
-   "Write output to a file named as the remote file",
+   "Write output to file named as remote file",
    CURLHELP_IMPORTANT | CURLHELP_OUTPUT},
   {"    --remote-name-all",
    "Use the remote filename for all URLs",
    CURLHELP_OUTPUT},
   {"-R, --remote-time",
-   "Set the remote file's time on the local output",
+   "Set remote file's time on local output",
    CURLHELP_OUTPUT},
   {"    --remove-on-error",
    "Remove output file on errors",
@@ -610,16 +610,16 @@ const struct helptxt helptext[] = {
    "Specify the target for this request",
    CURLHELP_HTTP},
   {"    --resolve <[+]host:port:addr[,addr]...>",
-   "Resolve the host+port to this address",
+   "Resolve host+port to address",
    CURLHELP_CONNECTION | CURLHELP_DNS},
   {"    --retry <num>",
    "Retry request if transient problems occur",
    CURLHELP_CURL},
   {"    --retry-all-errors",
-   "Retry all errors (use with --retry)",
+   "Retry all errors (with --retry)",
    CURLHELP_CURL},
   {"    --retry-connrefused",
-   "Retry on connection refused (use with --retry)",
+   "Retry on connection refused (with --retry)",
    CURLHELP_CURL},
   {"    --retry-delay <seconds>",
    "Wait time between retries",
@@ -631,7 +631,7 @@ const struct helptxt helptext[] = {
    "Identity for SASL PLAIN authentication",
    CURLHELP_AUTH},
   {"    --sasl-ir",
-   "Enable initial response in SASL authentication",
+   "Initial response in SASL authentication",
    CURLHELP_AUTH},
   {"    --service-name <name>",
    "SPNEGO service name",
@@ -652,7 +652,7 @@ const struct helptxt helptext[] = {
    "SOCKS5 proxy on given host + port",
    CURLHELP_PROXY},
   {"    --socks5-basic",
-   "Enable username/password auth for SOCKS5 proxies",
+   "Username/password auth for SOCKS5 proxies",
    CURLHELP_PROXY | CURLHELP_AUTH},
   {"    --socks5-gssapi",
    "Enable GSS-API auth for SOCKS5 proxies",
@@ -673,7 +673,7 @@ const struct helptxt helptext[] = {
    "Trigger 'speed-limit' abort after this time",
    CURLHELP_CONNECTION},
   {"    --ssl",
-   "Try SSL/TLS",
+   "Try enabling TLS",
    CURLHELP_TLS},
   {"    --ssl-allow-beast",
    "Allow security flaw to improve interop",
@@ -688,13 +688,13 @@ const struct helptxt helptext[] = {
    "Require SSL/TLS",
    CURLHELP_TLS},
   {"    --ssl-revoke-best-effort",
-   "Ignore missing/offline cert CRL dist points (Schannel)",
+   "Ignore missing cert CRL dist points",
    CURLHELP_TLS},
   {"-2, --sslv2",
-   "Use SSLv2",
+   "SSLv2",
    CURLHELP_TLS},
   {"-3, --sslv3",
-   "Use SSLv3",
+   "SSLv3",
    CURLHELP_TLS},
   {"    --stderr <file>",
    "Where to redirect stderr",
@@ -709,7 +709,7 @@ const struct helptxt helptext[] = {
    "Use TCP Fast Open",
    CURLHELP_CONNECTION},
   {"    --tcp-nodelay",
-   "Use the TCP_NODELAY option",
+   "Set TCP_NODELAY",
    CURLHELP_CONNECTION},
   {"-t, --telnet-option <opt=val>",
    "Set telnet option",
@@ -724,9 +724,9 @@ const struct helptxt helptext[] = {
    "Transfer based on a time condition",
    CURLHELP_HTTP | CURLHELP_FTP},
   {"    --tls-max <VERSION>",
-   "Set maximum allowed TLS version",
+   "Maximum allowed TLS version",
    CURLHELP_TLS},
-  {"    --tls13-ciphers <ciphersuite list>",
+  {"    --tls13-ciphers <list>",
    "TLS 1.3 cipher suites to use",
    CURLHELP_TLS},
   {"    --tlsauthtype <type>",
@@ -739,19 +739,19 @@ const struct helptxt helptext[] = {
    "TLS username",
    CURLHELP_TLS | CURLHELP_AUTH},
   {"-1, --tlsv1",
-   "Use TLSv1.0 or greater",
+   "TLSv1.0 or greater",
    CURLHELP_TLS},
   {"    --tlsv1.0",
-   "Use TLSv1.0 or greater",
+   "TLSv1.0 or greater",
    CURLHELP_TLS},
   {"    --tlsv1.1",
-   "Use TLSv1.1 or greater",
+   "TLSv1.1 or greater",
    CURLHELP_TLS},
   {"    --tlsv1.2",
-   "Use TLSv1.2 or greater",
+   "TLSv1.2 or greater",
    CURLHELP_TLS},
   {"    --tlsv1.3",
-   "Use TLSv1.3 or greater",
+   "TLSv1.3 or greater",
    CURLHELP_TLS},
   {"    --tr-encoding",
    "Request compressed transfer encoding",
@@ -766,7 +766,7 @@ const struct helptxt helptext[] = {
    "Details to log in trace/verbose output",
    CURLHELP_VERBOSE},
   {"    --trace-ids",
-   "Add transfer and connection identifiers to trace/verbose output",
+   "Transfer + connection ids in verbose output",
    CURLHELP_VERBOSE},
   {"    --trace-time",
    "Add time stamps to trace/verbose output",
@@ -802,7 +802,7 @@ const struct helptxt helptext[] = {
    "Show version number and quit",
    CURLHELP_IMPORTANT | CURLHELP_CURL},
   {"-w, --write-out <format>",
-   "Use output FORMAT after completion",
+   "Output FORMAT after completion",
    CURLHELP_VERBOSE},
   {"    --xattr",
    "Store metadata in extended file attributes",

diff --git a/tests/data/test1461 b/tests/data/test1461
index e25e29f39e6ad9e92cc3c6a2d78d9bcb3daaa23d..424af943fc9292d84c79eb2c05ed02f1916040f5 100644 (file)
--- a/tests/data/test1461
+++ b/tests/data/test1461
@@ -32,18 +32,18 @@ curl important --help
 </errorcode>
 <stdout mode="text">
 Usage: curl [options...] <url>
- -d, --data <data>          HTTP POST data
- -f, --fail                 Fail fast with no output on HTTP errors
- -h, --help <category>      Get help for commands
- -i, --include              Include protocol response headers in the output
- -o, --output <file>        Write to file instead of stdout
- -O, --remote-name          Write output to a file named as the remote file
- -s, --silent               Silent mode
- -T, --upload-file <file>   Transfer local FILE to destination
- -u, --user <user:password> Server user and password
- -A, --user-agent <name>    Send User-Agent <name> to server
- -v, --verbose              Make the operation more talkative
- -V, --version              Show version number and quit
+ -d, --data <data>           HTTP POST data
+ -f, --fail                  Fail fast with no output on HTTP errors
+ -h, --help <category>       Get help for commands
+ -i, --include               Include response headers in output
+ -o, --output <file>         Write to file instead of stdout
+ -O, --remote-name           Write output to file named as remote file
+ -s, --silent                Silent mode
+ -T, --upload-file <file>    Transfer local FILE to destination
+ -u, --user <user:password>  Server user and password
+ -A, --user-agent <name>     Send User-Agent <name> to server
+ -v, --verbose               Make the operation more talkative
+ -V, --version               Show version number and quit
 
 This is not the full help, this menu is stripped into categories.
 Use "--help category" to get an overview of all categories.

diff --git a/tests/data/test1463 b/tests/data/test1463
index c59ac552b81c1dad4ac8b3051d854d2862f31b3d..254b51b2227da30ed07b7b54dba5a65b3fd421e7 100644 (file)
--- a/tests/data/test1463
+++ b/tests/data/test1463
@@ -37,9 +37,9 @@ curl file category --help
 <stdout mode="text">
 Usage: curl [options...] <url>
 file: FILE protocol options
-     --create-file-mode <mode> File mode for created files
- -I, --head                    Show document info only
- -r, --range <range>           Retrieve only the bytes within RANGE
+     --create-file-mode <mode>  File mode for created files
+ -I, --head                     Show document info only
+ -r, --range <range>            Retrieve only the bytes within RANGE
 </stdout>
 </verify>
 </testcase>

diff --git a/tests/data/test1464 b/tests/data/test1464
index 091933df2d462d5be322d42b98265cd04357d27f..6a0af34c29ab91e31ab0497e8dbe3f5783aaa11f 100644 (file)
--- a/tests/data/test1464
+++ b/tests/data/test1464
@@ -37,9 +37,9 @@ curl file category --help with lower/upper mix
 <stdout mode="text">
 Usage: curl [options...] <url>
 file: FILE protocol options
-     --create-file-mode <mode> File mode for created files
- -I, --head                    Show document info only
- -r, --range <range>           Retrieve only the bytes within RANGE
+     --create-file-mode <mode>  File mode for created files
+ -I, --head                     Show document info only
+ -r, --range <range>            Retrieve only the bytes within RANGE
 </stdout>
 </verify>
 </testcase>