I managed mercurial man pages to be readable this way.
the .ftr can be put in troffrc and reformatting the title is optional.
hope can be usefull.
Index: Makefile
===================================================================
RCS file: /cvs/ports/devel/mercurial/Makefile,v
retrieving revision 1.23
diff -u -r1.23 Makefile
--- Makefile 12 Jan 2010 14:04:29 -0000 1.23
+++ Makefile 28 Mar 2010 13:48:46 -0000
@@ -34,6 +34,9 @@
undumprevlog rewrite-log simplemerge
post-install:
+ @perl -pi -e 's|^(\.TH HG 1 )"" "" ("Mercurial Manual".*)|\.ftr C
R\n\1\2|; \
+ s|\\:||g; \
+ s|^(\.de)1|\1|' ${WRKSRC}/doc/hg*.?
${INSTALL_MAN} ${WRKSRC}/doc/hg.1 ${PREFIX}/man/man1
${INSTALL_MAN} ${WRKSRC}/doc/hgignore.5 ${PREFIX}/man/man5
${INSTALL_MAN} ${WRKSRC}/doc/hgrc.5 ${PREFIX}/man/man5
