-
Notifications
You must be signed in to change notification settings - Fork 377
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
Help message is too long #377
Comments
Hi @jyn514, thanks for this. I agree it's very long! (And this isn't something that has been thought about since the early days of the project.) A couple of thoughts:
|
@dandavison if you want a man page, could you make that an explicit option, maybe with +1 to having -h be a summary, though :) |
+1 😄 |
Another option used by |
Really? If a system can't have access to a roff implementation (these have been around since the 1970s, but whatever) they could still convert the manpage using a tool like pandoc at build time. And if writing the manpage in the Literally putting the man page in This program is the only one on my system which manages to simultaneously have the shortest and longest help messages, while hiding the man page in |
Here is my low-effort attempt to do the right thing and generate a manpage: (Use GNU This is enough to get started, though the output is a bit ugly and needs more frobbing. help2man delta | sed 's/\x1b\[[0-9;]*m//g' | man -l - delta has the most man-like help page ever already but is just a little bit wrong. |
I'd like to improve this situation: I think making |
With the latest release, |
I just want to see what the common options are :/
The text was updated successfully, but these errors were encountered: