gbranden pushed a commit to branch master
in repository groff.
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.
Begins fixing <https://savannah.gnu.org/bugs/?66453>.
---
src/devices/gropdf/gropdf.1.man | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 954668f0d..dd5abfd90 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -10,6 +10,7 @@ output driver for Portable Document Format
.\" ====================================================================
.\"
.\" Copyright 2011-2025 Free Software Foundation, Inc.
+.\" 2026 G. Branden Robinson
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
@@ -1675,6 +1676,21 @@ or another datum supported by the PDF standard or your
reader.
must be prefixed with a slash.
.
.
+.TP
+.BR ".pdfnote " [ \-T\~\c
+.IR title ]\~ text
+Create an annotation in the document.
+.
+Reader support for this feature varies.
+.
+Some place an icon in the margin;
+hovering over the icon reveals any
+.IR title ,
+while clicking on the icon
+pops up a window containing
+.IR text .
+.
+.
.\" ====================================================================
.SS "Importing graphics"
.\" ====================================================================
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
