Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

revert(help): Partial revert of 3c049b4 #3179

Merged
merged 1 commit into from
Dec 15, 2021
Merged

revert(help): Partial revert of 3c049b4 #3179

merged 1 commit into from
Dec 15, 2021

Conversation

epage
Copy link
Member

@epage epage commented Dec 15, 2021

The extra whitespace was targeted at machine processing for a subset of
users for a subset of runs of CLIs. On the other hand, there is a lot
of concern over the extra verbose output.

A user can set the help template for man, if desired. They can even do
something (env? feature flag?) to make it only run when doing man
generation. We also have #3174 in the works.

So let's focus on the end-user reading --help. People wanting to use
help2man have workarounds to do what they need.

Fixes #3096

The extra whitespace was targeted at machine processing for a subset of
users for a subset of runs of CLIs.  On the other hand, there is a lot
of concern over the extra verbose output.

A user can set the help template for man, if desired.  They can even do
something (env? feature flag?) to make it only run when doing man
generation.  We also have clap-rs#3174 in the works.

So let's focus on the end-user reading `--help`.  People wanting to use
`help2man` have workarounds to do what they need.

Fixes clap-rs#3096
@epage epage merged commit f0c7a72 into clap-rs:master Dec 15, 2021
@epage epage deleted the man branch December 15, 2021 16:47
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.

Too much whitespace in output
1 participant