Milestone reached: hyperlinked man(7) documents in PDF

[G. Branden Robinson]

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