Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Manpage never mentions you can specify flags before each URL #2515
The SYNOPSIS section in the manpage says:
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).
I'm not sure how to improve it without making it over-complicated. Maybe
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).
curl's ability to re-use connections is totally unrelated to how you put the arguments on the command line... It will always attempt to re-use connections no matter that.
The quoted paragraph clued me to the fact that I can probably use curl to download several files in sequence from the same server. My next question was how to specify a new filename for each URL, and I had to search the web for an example, as the manpage wasn't helpful.
Hm, I missed that. That answers many of my questions. I still think it's not the right place to discover the "download multiple files at once" feature.
My suggestion is to copy the "Multiple transfers" section from the manual to the manpage.
I'm fine with