Re: Milestone reached: hyperlinked man(7) documents in PDF
On Thursday, 1 February 2024 20:58:09 GMT G. Branden Robinson wrote: > At 2024-01-31T13:19:18+, Deri wrote: > > Oops, did not mean to send that, although it does show okular working > > properly with an .MT link. > > I concur. It seems to only go wrong if the hotspots are misconfigured > in the PDF, as I found out when accidentally regressing something in my > working copy. (Savannah #65233, fixed and pushed yesterday, didn't > help.) > > I'm working on #61434 now, and learning things I didn't know about input > traps and diversion nesting... > > Regards, > Branden Hi Branden, I don't understand what you mean by "misconfigured hotspots". Your push for #65233 fixed the problem of .MT following a .TP turning off all further .MT's (because you were unsetting the an*do-hyperlink flag which affected all further .MT's). This email thread mentioned the "PDF hyperlinks working in Evice and xpdf but not Okular" email you sent earlier, and my screenshot shows the links working in okular using the groff_man_pages.pdf in your drop box, which you asked people to test. In fact I have tested with these viewers - okular, evince, mupdf-gl, qpdfview, atril, firefox, chromium and xpdf - all allowed me to click on the coloured hotlink. As far as okular is concerned, there was a problem with okular actioning hot links if okular was reading from stdin rather than a file, see https:// bugs.kde.org/show_bug.cgi?id=472440, but it is fixed now. Cheers Deri
Re: Milestone reached: hyperlinked man(7) documents in PDF
At 2024-01-31T13:19:18+, Deri wrote: > Oops, did not mean to send that, although it does show okular working > properly with an .MT link. I concur. It seems to only go wrong if the hotspots are misconfigured in the PDF, as I found out when accidentally regressing something in my working copy. (Savannah #65233, fixed and pushed yesterday, didn't help.) I'm working on #61434 now, and learning things I didn't know about input traps and diversion nesting... Regards, Branden signature.asc Description: PGP signature
Re: Milestone reached: hyperlinked man(7) documents in PDF
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.
Milestone reached: hyperlinked man(7) documents in PDF
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
