Re: 22/27: gropdf(1): Document `pdfnote` macro.

On Sunday, 18 January 2026 23:41:42 GMT G. Branden Robinson wrote:
> Hi Deri,
> 
> At 2026-01-18T22:57:49+0000, Deri via groff-commit wrote:
> > > commit 9377ac54c5af5c5eb6f5a12dbcbcc101f6df4087
> > > Author: G. Branden Robinson <[email protected]>
> > > AuthorDate: Thu Jan 15 20:05:50 2026 -0600
> > > 
> > >     gropdf(1): Document `pdfnote` macro.
> > >     
> > >     I had pretty bad luck with reader support for annotations.
> > >     
> > >     * okular(1) and xpdf(1) show the icon but hovering and clicking
> > >     
> > >       do nothing.
> > >     
> > >     * evince(1) shows the icon.  Clicking on it pops open a window
> > >     
> > >       showing the title, but not the text (even though there's
> > >       copious space for it).
> > >     
> > >     * Firefox's built-in PDF viewer seems to offer full support as
> > >     
> > >       described here.
> > 
> > These are my findings:-
> > 
> > Viewer       Version       Icon   Hover   Click   Dbl‐Click
> > ─────────────────────────────────────────────────────────────
> > okular     23.04.3           y     y[3]      n         y
> > evince     44.2              y       y       y         ‐
> > xpdf       4.05              n       ‐       ‐         ‐
> > atril      1.26.1            y       y     y[4]        ‐
> > mupdf‐gl   1.11              y       n       n         ‐
> > qpdfview   0.50              y       y       y         ‐
> > zathura    0.5.5             y       n       n         ‐
> > acrobat    windows           y       y       y         ‐
> > firefox    140.6.0esr        y       y       y         ‐
> > chromium   136.0.7103.113    y       y       n         ‐
> > 
> > ───────────
> > 
> >  [1] Okular must not be in text selection mode.
> >  [2] Right click, Annotation Properties
> 
> Thanks, Deri!  Good stuff!  I'm considering making a record-my-desktop
> video with voice over to summarize the new stuff in groff 1.24.0 (for
> upload to social media[1]), and this chart is an excellent resource to
> have available when talking about the new `pdfnote` macro that gropdf
> supports.
> 
> Regards,
> Branden
> 
> [1] I need to ask Jim Hall for some tips!

Here's the code which made the table.

.pl 4.6i
.TS
;
C C C C C C
_ _ _ _ _ _
L L C C C C.
Viewer	Version	Icon	Hover	Click	Dbl-Click
okular	23.04.3	y	y\**	n	y
evince	44.2	y	y	y	-
xpdf	4.05	n	-	-	-
atril	1.26.1	y	y	y\**	-
mupdf-gl	1.11	y	n	n	-
qpdfview	0.50	y	y	y	-
zathura	0.5.5	y	n	n	-
acrobat	windows	y	y	y	-
firefox	140.6.0esr	y	y	y	-
chromium	136.0.7103.113	y	y	n	-
.TE
.FS
Okular must not be in text selection mode.
.FE
.FS
Right click, Annotation Properties
.FE