Mark --subcommands options with `terminal_output` tag - Githubissues

bazelbuild / bazel

a fast, scalable, multi-language and extensible build system

https://bazel.build

Apache License 2.0

23.22k stars 4.07k forks source link

Mark --subcommands options with `terminal_output` tag #10771

Closed Profpatsch closed 3 years ago

Profpatsch commented 4 years ago

Description of the problem / feature request:

There’s a Tags: line with categorizes command line arguments which is very helpful for finding related arguments.

terminal_output marks flag which change the terminal output:

screenshot

--subcommands is a pretty obvious argument which does that, but it’s missing the tag:

screenshot

Feature requests: what underlying problem are you trying to solve with this feature?

Make it easier to discover related CLI arguments (the help output is sorted alphabetically and has no priorization).

Bugs: what's the simplest, easiest way to reproduce this bug? Please provide a minimal example if possible.

Add the tag to subcommands and maybe check the tags on all other flags for consistency at the same time.

What operating system are you running Bazel on?

Nixos 20.01

What's the output of `bazel info release`?

> bazel info release
INFO: Invocation ID: 2d12afa9-6016-4535-ac1c-f36c20a8814c
release 2.0.0- (@non-git)

If `bazel info release` returns "development version" or "(@non-git)", tell us how you built Bazel.

bazel from nixpkgs

philwo commented 3 years ago

This was fixed in https://github.com/bazelbuild/bazel/commit/1329798b8a60c2f36d9f441496bf38e3e4a0f692.