On Tue, Jun 08, 2010 at 06:46:56PM +0100, Colin Watson wrote: > The following patch improves the man pages we generate by giving them > decent NAME sections, which are included in indexes of man pages and so > are worth getting right. help2man's default is something like > "grub-bin2h \- manual page for grub-bin2h (GRUB) 1.98" which is of > course hopeless in an index.
What I do for Mailutils is extracting the NAME section on the fly. It's not really robust, as a change in the help output can break it (although lintian would probably nag us really quickly), but the problem with this approach is that if the description changes in the program, it needs to be manually updated in the h2m helpers. http://svn.debian.org/viewsvn/pkg-mailutils/trunk/debian/mangen.sh?revision=348&view=markup Jordi -- Jordi Mallach Pérez -- Debian developer http://www.debian.org/ jo...@sindominio.net jo...@debian.org http://www.sindominio.net/ GnuPG public key information available at http://oskuro.net/
signature.asc
Description: Digital signature
_______________________________________________ Grub-devel mailing list Grub-devel@gnu.org http://lists.gnu.org/mailman/listinfo/grub-devel
