Description
The SYNOPSIS section in the manpage says:
curl [options] [URL...]
This is incorrect, as more options can be specified before each URL, and each set of options only applies to the URL after it (if I understand correctly. It's unclear).
You can also specify flags after the URL, as mentioned in the MANUAL section referenced below, which is odd and I don't think it's documented.
I'm not sure how to improve it without making it over-complicated. Maybe [[options] [URL ...]] ...
.
(man(7)
uses a similar [[section] page[.section] ...] ...
)
The manpage does say "curl will attempt to re-use connections for multiple file transfers", but doesn't explain how to go about it (e.g. with flags before each URL).
The file MANUAL
contains the section "MULTIPLE TRANSFERS WITH A SINGLE COMMAND LINE". It's informative and should be copied to the manpage, after the section about re-using connections.
curl/libcurl version
7.55.1