curl.1: mention "global" flags

Mention options that are "global". A global command line option is one
that doesn't get reset at --next uses and therefore don't need to be
used again.

Reported-by: Josh Soref
Fixes #7457
Closes #7510

diff --git a/docs/cmdline-opts/libcurl.d b/docs/cmdline-opts/libcurl.d
index 60921f5f9134c3cc79ebc2df44f5526332dbe992..40160824ace95f6dd4252f4badc99476f636cee9 100644 (file)
--- a/docs/cmdline-opts/libcurl.d
+++ b/docs/cmdline-opts/libcurl.d
@@ -8,5 +8,8 @@ Append this option to any ordinary curl command line, and you will get
 libcurl-using C source code written to the file that does the equivalent
 of what your command-line operation does!
 
+This option is global and does not need to be specified for each use of
+--next.
+
 If this option is used several times, the last given file name will be
 used.

diff --git a/docs/cmdline-opts/parallel-immediate.d b/docs/cmdline-opts/parallel-immediate.d
index 95c8afc42cffb0aa6c8b81d5ca033349a108cba1..47b9a7900a7e3f8c18a3ad2bb891b61341f99c96 100644 (file)
--- a/docs/cmdline-opts/parallel-immediate.d
+++ b/docs/cmdline-opts/parallel-immediate.d
@@ -8,3 +8,6 @@ When doing parallel transfers, this option will instruct curl that it should
 rather prefer opening up more connections in parallel at once rather than
 waiting to see if new transfers can be added as multiplexed streams on another
 connection.
+
+This option is global and does not need to be specified for each use of
+--next.

diff --git a/docs/cmdline-opts/parallel-max.d b/docs/cmdline-opts/parallel-max.d
index c265b7204e8aca146a226490923e29f061f7fff1..9ec807cddad06fd5b0309f449570d8981804f361 100644 (file)
--- a/docs/cmdline-opts/parallel-max.d
+++ b/docs/cmdline-opts/parallel-max.d
@@ -8,4 +8,7 @@ Category: connection curl
 When asked to do parallel transfers, using --parallel, this option controls
 the maximum amount of transfers to do simultaneously.
 
+This option is global and does not need to be specified for each use of
+--next.
+
 The default is 50.

diff --git a/docs/cmdline-opts/parallel.d b/docs/cmdline-opts/parallel.d
index d6b4affe3763a371bd4fa36a20a2cad784c9619e..d49158c24291f4be9bf9ddd2ea0d38ec1d90797b 100644 (file)
--- a/docs/cmdline-opts/parallel.d
+++ b/docs/cmdline-opts/parallel.d
@@ -6,3 +6,6 @@ Category: connection curl
 ---
 Makes curl perform its transfers in parallel as compared to the regular serial
 manner.
+
+This option is global and does not need to be specified for each use of
+--next.

diff --git a/docs/cmdline-opts/progress-bar.d b/docs/cmdline-opts/progress-bar.d
index 299d5384a42cf489cc4f5a1118be2efaf72fc6ae..ad2f21b87e70045066c11dd0d8d264714dab622a 100644 (file)
--- a/docs/cmdline-opts/progress-bar.d
+++ b/docs/cmdline-opts/progress-bar.d
@@ -11,3 +11,6 @@ shows a percentage if the transfer size is known. For transfers without a
 known size, there will be space ship (-=o=-) that moves back and forth but
 only while data is being transferred, with a set of flying hash sign symbols on
 top.
+
+This option is global and does not need to be specified for each use of
+--next.

diff --git a/docs/cmdline-opts/show-error.d b/docs/cmdline-opts/show-error.d
index 2124409e5669c4b6a6daafe65217a9bc60eac5b3..258949a500b555674e1b133c4a22be7545984ff5 100644 (file)
--- a/docs/cmdline-opts/show-error.d
+++ b/docs/cmdline-opts/show-error.d
@@ -5,3 +5,6 @@ See-also: no-progress-meter
 Category: curl
 ---
 When used with --silent, it makes curl show an error message if it fails.
+
+This option is global and does not need to be specified for each use of
+--next.

diff --git a/docs/cmdline-opts/stderr.d b/docs/cmdline-opts/stderr.d
index 1154efb33283d137e495295e575e1cbe7c90fb9e..737df6393a52ad442638a0e6c70a269306060a61 100644 (file)
--- a/docs/cmdline-opts/stderr.d
+++ b/docs/cmdline-opts/stderr.d
@@ -7,4 +7,7 @@ Category: verbose
 Redirect all writes to stderr to the specified file instead. If the file name
 is a plain '-', it is instead written to stdout.
 
+This option is global and does not need to be specified for each use of
+--next.
+
 If this option is used several times, the last one will be used.

diff --git a/docs/cmdline-opts/styled-output.d b/docs/cmdline-opts/styled-output.d
index 8aa4a0f05efb82d12fa2e0acabe88a30600d53ad..91d36eca7a8242f730c0f19c90341e93e161bd44 100644 (file)
--- a/docs/cmdline-opts/styled-output.d
+++ b/docs/cmdline-opts/styled-output.d
@@ -5,3 +5,6 @@ Category: verbose
 ---
 Enables the automatic use of bold font styles when writing HTTP headers to the
 terminal. Use --no-styled-output to switch them off.
+
+This option is global and does not need to be specified for each use of
+--next.

diff --git a/docs/cmdline-opts/trace-ascii.d b/docs/cmdline-opts/trace-ascii.d
index fa7e16ccc1fe8bfd180818a2ae0ee6bb68a83875..461ea6fe5de7d284341c471db5a6f58d4dafe6ee 100644 (file)
--- a/docs/cmdline-opts/trace-ascii.d
+++ b/docs/cmdline-opts/trace-ascii.d
@@ -12,4 +12,7 @@ This is very similar to --trace, but leaves out the hex part and only shows
 the ASCII part of the dump. It makes smaller output that might be easier to
 read for untrained humans.
 
+This option is global and does not need to be specified for each use of
+--next.
+
 If this option is used several times, the last one will be used.

diff --git a/docs/cmdline-opts/trace-time.d b/docs/cmdline-opts/trace-time.d
index 19a31a70e17bed193a356cab8ac73ea39b944148..81e28e3cec10957a324f8143b506c08e6d45ba29 100644 (file)
--- a/docs/cmdline-opts/trace-time.d
+++ b/docs/cmdline-opts/trace-time.d
@@ -4,3 +4,6 @@ Added: 7.14.0
 Category: verbose
 ---
 Prepends a time stamp to each trace or verbose line that curl displays.
+
+This option is global and does not need to be specified for each use of
+--next.

diff --git a/docs/cmdline-opts/trace.d b/docs/cmdline-opts/trace.d
index 502dafd71f65600010f20cc9d11c6aee2a54a48c..5788f9965979e7e16f2bdcce9248b01ecc0d02ae 100644 (file)
--- a/docs/cmdline-opts/trace.d
+++ b/docs/cmdline-opts/trace.d
@@ -9,4 +9,7 @@ descriptive information, to the given output file. Use "-" as filename to have
 the output sent to stdout. Use "%" as filename to have the output sent to
 stderr.
 
+This option is global and does not need to be specified for each use of
+--next.
+
 If this option is used several times, the last one will be used.

diff --git a/docs/cmdline-opts/verbose.d b/docs/cmdline-opts/verbose.d
index 8db1ea222b062d7a8e3f25c9f7d08299b463ad17..497eeb6d4b6e67a2d7884469bca20dcb2b28bf84 100644 (file)
--- a/docs/cmdline-opts/verbose.d
+++ b/docs/cmdline-opts/verbose.d
@@ -17,4 +17,7 @@ you're looking for.
 If you think this option still doesn't give you enough details, consider using
 --trace or --trace-ascii instead.
 
+This option is global and does not need to be specified for each use of
+--next.
+
 Use --silent to make curl really quiet.