Skip to content

Promote -v and -q option to standard option displayed by -h #4623

Open

Description

@tats-u

Is your feature request related to a problem? Please describe.
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

#4455 (comment)
#4619 (comment)

One more thing, not a few beginners mistakenly try to show its version by -v flag. They will get:

zstd -v
*** Zstandard CLI (64-bit) v1.5.7, by Yann Collet ***
stdin is a console, aborting

This "unknown" behavior must be described by -h.

Describe the solution you'd like
A clear and concise description of what you want to happen.

-h should display how to use -v and -q like the other competing commands (e.g. gzip).

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Who on earth cares?

Additional context
Add any other context or screenshots about the feature request here.

See #4455 (comment) for the output of each command.

Activity

  1. changed the title [-]Promote -q option to standard option displayed by -h[/-] [+]Promote -v and -q option to standard option displayed by -h[/+] on Mar 22, 2026
  2. tats-u commented on Mar 22, 2026

    @tats-u
    Author

    @Cyan4973

    So we could also bring -v along with -q? But now it introduces another question: which options deserves to be tagged "important", and be promoted to first help screen (as opposed to the more advanced and complete -H). We can't just promote everything blindly, because if everything is important, nothing is.

    As you pointed out, I think -v should be promoted, too. Generally speaking, -v means --version except for compression/decompression commands like zstd. Not a few users will try -v once. It deserved to be promoted. Whether a certain option deserves to be promoted depends on whether it exists in -h of many other competing commands (e.g. gzip).

  3. tats-u commented on Mar 22, 2026

    @tats-u
    Author

    I will submit the following Copilot slop if you approve on this promotion:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions