cmdline-opts: expand the parallel explanations

Closes #13886

docs/cmdline-opts/parallel-immediate.md

@@ -16,7 +16,10 @@ Example:
 
 # `--parallel-immediate`
 
-When doing parallel transfers, this option instructs curl that it should
+When doing parallel transfers, this option instructs curl to prefer opening up
-rather prefer opening up more connections in parallel at once rather than
+more connections in parallel at once rather than waiting to see if new
-waiting to see if new transfers can be added as multiplexed streams on another
+transfers can be added as multiplexed streams on another connection.
-connection.
+
+By default, without this option set, curl prefers to wait a little and
+multiplex new transfers over existing connections. It keeps the number of
+connections low at the expense of risking a slightly slower transfer startup.

docs/cmdline-opts/parallel-max.md

@@ -7,6 +7,7 @@ Help: Maximum concurrency for parallel transfers
 Added: 7.66.0
 Category: connection curl
 Multi: single
+Scope: global
 See-also:
   - parallel
 Example:
@@ -18,7 +19,5 @@ Example:
 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
+The default is 50. 300 is the largest supported value.
---next.
 
-The default is 50.

docs/cmdline-opts/parallel.md

@@ -11,11 +11,22 @@ Scope: global
 See-also:
   - next
   - verbose
+  - parallel-max
+  - parallel-immediate
 Example:
   - --parallel $URL -o file1 $URL -o file2
 ---
 
 # `--parallel`
 
-Makes curl perform its transfers in parallel as compared to the regular serial
+Makes curl perform all transfers in parallel as compared to the regular serial
-manner.
+manner. Parallel transfer means that curl runs up to N concurrent transfers
+simultaneously and if there are more than N transfers to handle, it starts new
+ones when earlier transfers finish.
+
+With parallel transfers, the progress meter output is different than when
+doing serial transfers, as it then displays the transfer status for multiple
+transfers in a single line.
+
+The maximum amount of concurrent transfers is set with --parallel-max and it
+defaults to 50.