html2man is exactly for simple tools that hardly need any man page.
Your workaround gives a wrong result though:
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.43.3.
.THUSAGE:"1""February 2014""Usage: mwaw2csv [OPTION][-o file.csv] <AppleWorks/ClarisWorks Database/Spreadsheet>""User Commands"
.SHNAME
Usage: \- manual page for Usage: mwaw2csv [OPTION][-o file.csv] <AppleWorks/ClarisWorks Database/Spreadsheet>
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
So something on the first line does not fit the pattern help2man uses. That is hardly our fault.
Btw, using --help-option is not a workaround. To cover cases other than the most common (or simple) one is the reason tools do have options. And plain "help2man mwaw2csv" actually works too (help2man 1.43.3).
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Just use
help2man --help-option=-h mwaw2csv
. Anyway, the tool is so simple it hardly needs any man page.
html2man is exactly for simple tools that hardly need any man page.
Your workaround gives a wrong result though:
So something on the first line does not fit the pattern help2man uses. That is hardly our fault.
Btw, using --help-option is not a workaround. To cover cases other than the most common (or simple) one is the reason tools do have options. And plain "help2man mwaw2csv" actually works too (help2man 1.43.3).
I just downloaded help2man and do some tests, you need also to define the version string. I.e.
help2man --help-option=-h --version-string=0.1.9 mwaw2csv
will probably give much better result...
Just for note, when libmwaw-0.3.0 will be released, the man created by
will look better (see https://sourceforge.net/p/libmwaw/libmwaw/ci/256f795e6308dad4f312649f84ff1c4006ce12be/ )...
Last edit: alonso laurent 2014-02-08