CLIUtils / CLI11

CLI11 is a command line parser for C++11 and beyond that provides a rich feature set with a simple and intuitive interface.
https://cliutils.github.io/CLI11/book/
Other
3.41k stars 358 forks source link

Man page generation #413

Open phlptp opened 4 years ago

phlptp commented 4 years ago

As part of our library we are using CLI11 to mange the command line options for several executables. These executables need man pages in some way. This is largely a manual process right now, but we are toying with the idea of trying to get CLI11 to generate pieces that can be used as an include for man page generators. For example in asciidoc. There are sections of typical man pages that I think CLI11 could generate in a relatively straightforward fashion that could be used as part of a man file generation process.

Not entirely sure what the mechanics of this would be yet, probably would be related to some general updates to the capabilities of the formatters for #353 and #355.

This is probably something I might work on in the next couple months, but thought I would put it out there see if anyone has any opinions or other ideas, especially about how the mechanics might work.

KOLANICH commented 4 years ago

https://www.gnu.org/software/help2man/