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

[Deri]

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

Screenshot_20240131_120554.png
Description: PNG image