Use help2man to automatically generate man pages #899
Conversation
|
Fancy. Would also get the output of custom plugins people install. I'll test this out later today. |
|
Ah, it is currently only generated during bootstrap, so it won't list the help for custom plugins that are installed after that script is run. It could easily be generated each time |
Makes it easier to be parsed by `help2man`
|
That header should read "OPTIONS" instead of "DESCRIPTION," so I've added an "Options:" header to the help text to get the correct header generated. |
|
Fine with me. Merging. I'll be sure to run this before every release. |
Use help2man to automatically generate man pages
|
@josegonzalez No need, it generates it anew with each installation during execution of |
|
...and now on install/upgrade https://github.com/progrium/dokku/blob/00babb5ff514a3bbbffdd06dbea95be33800c978/Makefile#L48 |
As much as I love updating the man pages for every new version, I guess writing the man pages automatically would be a bit easier :)
The only difference is that help2man won't underline/italicize the command args, but I never cared much for that anyhow.
EDIT: It uses
help2man, documented here.