I’ve been working on a tool written in Rust for the past few months, and getting very close to putting it into production at Mozilla. After that milestone I’m planning on doing some work to make it usable for developers in general. One thing I haven’t found a good answer for is writing useful documentation for a command-line tool. rustdoc is great for library crates, but it doesn’t seem very useful for a tool, where you want to document the command-line options and other features.
Obviously I could just hand-write some documentation in markdown or HTML, but it would be nice if I could also have the documentation for command-line options generated from the data structures I’m passing to clap that define the allowed set of options.
I did a little brief searching and didn’t find anything relevant to this problem, although there is a semi-related issue in the Rust tracker for providing HTML versions of the man pages for rustccargo et. al. Those man pages appear to just be committed to the rust and cargo repositories as-is. It might be nice if it was possible to generate them from the source as well, so that as much of the documentation could live near the code that declares it as possible.
If anyone knows of any efforts in this area I’d love to hear about them!
This looks useful, thanks! I was hoping that someone had already done some work in this space so I wouldn’t have to write something myself, but I appreciate that the Rust community always generally has something helpful to work from. I’ll make some noise if I find time to build something to make this better.
Holy crap, this is a hell of a setup. I would love if this would be less complicated. Best idea would be a clap->manpage functionality where one is able to attach own text to the output…