traitlets icon indicating copy to clipboard operation
traitlets copied to clipboard

Generate manpage from configuration options

Open jasongrout opened this issue 5 years ago • 1 comments

In https://github.com/jupyter/jupyter_server/issues/320, @SnarkBoojum submitted a manpage for Jupyter Server that largely encoded the results from --help. We realized that it would make more sense to have an automatically generated manpage at the traitlet level from the configurable traits. This issue is about adding a --generate-manpage option, or perhaps a separate manpage generation command, that does something similar to -h, but generates the output as a manpage.

jasongrout avatar Oct 31 '20 07:10 jasongrout

I don't know anything about traitlets (even though I'm also the one packaging it for Debian!); and not much about manpages : when the need arises, I take an existing manpage and use it as a guide : it's a just a markup language.

SnarkBoojum avatar Oct 31 '20 15:10 SnarkBoojum