Re: Milestone reached: hyperlinked man(7) documents in PDF

[Deri]

On Wednesday, 31 January 2024 13:02:57 GMT Deri wrote:
> On Wednesday, 31 January 2024 05:10:21 GMT G. Branden Robinson wrote:
> > 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

Oops, did not mean to send that, although it does show okular working properly 
with an .MT link.