Skip to content

Add verbiage to --help - #437

Open
apiraino wants to merge 2 commits into
rust-lang:masterfrom
apiraino:improve-arg-desc
Open

Add verbiage to --help#437
apiraino wants to merge 2 commits into
rust-lang:masterfrom
apiraino:improve-arg-desc

Conversation

@apiraino

@apiraino apiraino commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

From comment

Now the help mentions that verbose can be double :)

-v, --verbose...
          Multiple -v options increase verbosity, including the output of the bisection command. The maximum is 2.

@RalfJung does it look better?

@RalfJung

Copy link
Copy Markdown
Member

Thanks! Maybe also mention that the output of the checked program (or whatever term you are using for this) is shown with level 2?

@apiraino

Copy link
Copy Markdown
Contributor Author

I am not sure what you were looking for, but I hope the updated text looks now better.

@RalfJung

Copy link
Copy Markdown
Member

I can confirm that -vv does print the program output, in the case of what I was bisecting that was

I will run `"rustup" "component" "add" "rust-src"` to install the `rust-src` component for the selected toolchain. Proceed? [Y/n] error: toolchain 'bisector-nightly-2026-08-04-x86_64-unknown-linux-gnu' does not support components
fatal error: failed to install the `rust-src` component for the selected toolchain

That can be extremely important information to figure out why the bisect does not behave as expected.

Comment thread src/main.rs Outdated
@apiraino

Copy link
Copy Markdown
Contributor Author

thanks Ralf. I've added a small additional tip also for thr --script parameter

@RalfJung

Copy link
Copy Markdown
Member

That's potentially confusing since -vv shows the output also for the cargo command without --script (I did not use --script when I ran into this).

Co-authored-by: Ralf Jung <post@ralfj.de>
@apiraino

Copy link
Copy Markdown
Contributor Author

ok, reverted to only changing the inline help for -v / -vv parameters.

@RalfJung

RalfJung commented Aug 12, 2026 via email

Copy link
Copy Markdown
Member

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants