podman secret create [options] NAME FILE|-

[ratijas]

Reading documentation for podman secret create, I got confused by this syntax which almost looks like an unintentional typo or a formatting glitch:

podman secret create [options] name file|-

So I went out of my ways to clone the repo, pinpoint the offending line, and check its commit history… only to realize that it is a totally intentional "file OR literal minus sign", not a pipe to a fictional '-' command.

Is there any cleaner alternative syntax which doesn't look like a broken line ending?

[Luap99]

The pipe symbol is commonly used character in usage lines to mean either or.

That said I am not sure showing - gains us anything in the usage line there. It might be cleart o simply document that as special case if file equals - we read from stdin.