Hi folks, In a frenzy of activity over the past few days Deri and I have landed everything necessary to bring full hyperlink support to man(7) documents in PDF.
* The MT/ME macros hyperlink email addresses. * The UR/UE macros hyperlink general URLs. * The MR macro produces "man:foo(1)"-style hyperlinks. This should have been easier than it was, but I'll save my gripes about why it wasn't for a postmortem at another time. :) Further, Deri's "groff man pages book" is now the "official" groff-man-pages.pdf document. It adds a spare but attractive cover page and, importantly, "internalizes" the man page hyperlinks when the document itself provides the page in question. "External" man pages remain in "man:foo(1)" form. I've successfully tested these features in Evince and xpdf. Okular is giving me problems as I reported to this list earlier today. As always, you can check out the latest version of this and other groff documents in a Dropbox folder. https://www.dropbox.com/sh/17ftu3z31couf07/AAC_9kq0ZA-Ra2ZhmZFWlLuva?dl=0 I'd appreciate feedback and particularly any report of bugs that you may spot. What next? ========== mdoc(7) needs feature parity via its `Mt`, `Lk`, and `Xr`. I'm already working toward that, as recent commits will suggest. Then we can say that we have full PDF hyperlink support for _man pages_. In man(7), it sure would be nice if we could turn paragraph tags into hyperlinked text (this already works for `MR`, but not `MT` and `UR`). I'm working on that, too. Regards, Branden
signature.asc
Description: PGP signature