Hey, EMACS: First parameter, NAME, should be all caps Second parameter, SECTION, should be 1-8, maybe w/ subsection other parameters are allowed: see man(7), man(1)
NAMEkdemangen.pl - automatically create a draft manpage for a KDE app
DESCRIPTIONkdemangen.pl will automatically create a draft manpage for a KDE application. Manpages are always better when hand-tailored, but this should give you a fairly good start.
To create the manpage, it will use the --author and --help-all output for the application passed on the command line. It will also use the description in the Debian control file if one is available. To make use of this additional feature, you must run kdemangen.pl from within the debian/ subdirectory of the application sources.
The new manpage will be written to standard output.
This utility is part of the KDE Software Development Kit.
WARNINGThis utility will only work for a full KDE application that uses KCmdLineArgs (which most full KDE applications do).
kdemangen /usr/bin/kstars > kstars.1
AUTHORkdemangen.pl was written by Dominique Devriese <firstname.lastname@example.org>.
This manual page was prepared by Ben Burton <email@example.com> for the Debian GNU/Linux system (but may be used by others).