Skip to content

Manpage never mentions you can specify flags before each URL #2515

Closed
@salty-horse

Description

@salty-horse

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions