Tue 28 May 2013 12:52:26 PM UTC, original submission:
help2man produces by default a frankly embarrassing NAME paragraph which is really not very useful at all, but is unfortunately the best that we can do given that there is no consistent text in the --help output which could otherwise be used.
Note that as well as being included in the manual page, this text is displayed in the whatis(1) output, and searched/displayed by apropos(1) so it is helpful for it to be something other than the default boiler-plate.
The typical fix is either to provide the text via the --name option, or in a [NAME] section of an include file.
I recently received a bug report for help2man about problems with parsing the output of cd-drive, specifically that the --libtool option was not stripping the "lt-" prefix, which led me to look at your include files.
I've just uploaded help2man-1.42.1 which I believe should fix the "lt-" prefix issue.
Attached is a patch to the .help2man files which moves the program description from SYNOPSIS to NAME, so "whatis cd-info" and "apropos cd-" should work correctly.
The new release described above should make the post-processing with sed to remove "lt-" unnecessary, but obviously it would not hurt to keep it for some time while people upgrade.
--bod (help2man maintainer)
|