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

[G. Branden Robinson]

Hi Deri,

At 2024-02-02T01:15:55+0000, Deri wrote:
> I don't understand what you mean by "misconfigured hotspots".

I'm sorry I wasn't very clear.  I was referring to blunders I was making
during development of my working copy, not necessarily anything that
would be visible to people building an unmodified groff from Git.

It _appears_ to me, though I've not arsing myself to come up with a
demonstration of this right now because I'm 13 commits or so deep into a
refactoring-happy solution to Savannah #61434, and this >< close to
having it completely solved.[1]

(The only lingering problem I'm seeing is that the paragraph tag's line
is getting broken even when the tag is short enough to fit.  But apart
from that, the link works, nothing else is hosed, and it shuts up...

  warning: cannot nest .MT or .UR inside .TP; ending paragraph tag

...that.  Screenshot attached.)

Anyway, it _appears_ to me that if you leave any hotspot half-open,
Okular will ignore all hotspots in the entire document.  But again, I
haven't written a simple, convincing test of this--just managed to screw
things up while flinging device control commands from man pages.

> 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).

Right.  That was _a_ problem but not the only problem I saw.

> 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.

Fantastic!  You've used PDF viewers I haven't even heard of.

> 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.

Ah, reported and fixed in July of last year.  I reckon Debian stable is
going to be stuck with that one for a while.  Maybe they'll get the fix
about the same time they get groff 1.24...

Regards,
Branden

[1] Sneak preview:

$ git log --oneline origin..HEAD
f6d4c86f9 (HEAD -> master) [man]: Refactor, giving `TP` its own trap.
8d978f872 tmac/an.tmac: Refactor.
2a344e550 tmac/an.tmac (TP): Refactor.
7851d46b2 tmac/an.tmac: Refactor hyperlink management.
b53a54627 [tests]: Migrate to more recent test conventions.
08cf152ba src/roff/troff/input.cpp: Fix code style nit.
1ef483a48 tmac/an.tmac (an-end): Call `an-input-trap`.
b58406d0f [man]: Add unit test for `TP` macro.
d1811c1b0 [grotty]: Improve error diagnostic.
8edd459c7 [man]: Revise and add test cases.
261b0a0c7 tmac/an.tmac: Trivially refactor.
619b52f09 XXX [troff]: Implement `.it`, `.itc`, and `.itm` registers.
c0a18a32a [troff]: Trivially refactor; rename and boolify.

savannah_61434_semi-fixed.png
Description: PNG image

signature.asc
Description: PGP signature