gbranden pushed a commit to branch master
in repository groff.
commit 633e4123a977fe7b37ef9ca9e471261a04a6d378
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jan 15 20:05:50 2026 -0600
gropdf(1): Document `pdfhref` macro with `W` arg.
Fixes <https://savannah.gnu.org/bugs/?66453>. Thanks to Deri James for
supplying an overview of features in Savannah #67665.
---
ChangeLog | 8 +++++++
src/devices/gropdf/gropdf.1.man | 48 +++++++++++++++++++++++++++++++++++++++++
2 files changed, 56 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index 9364ac6b7..4b19cf898 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2026-01-15 G. Branden Robinson <[email protected]>
+
+ * src/devices/gropdf/gropdf.1.man (Macros) <pdfbookmark>
+ <pdfnote, pdhref>: Document macros.
+
+ Fixes <https://savannah.gnu.org/bugs/?66453>. Thanks to Deri
+ James for supplying an overview of features in Savannah #67665.
+
2026-01-14 G. Branden Robinson <[email protected]>
* src/devices/gropdf/gropdf.1.man (Usage): Drop references to
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 542090728..15057f917 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -1758,6 +1758,54 @@ as text in the document as well.
.
.
.TP
+.BR ".pdfhref W" \~\c
+.BI \-D\~ uri\~\c
+.RB [ \-S ] \~\c
+.RB [ \-P \~\c
+.IR prefix-text "] \c"
+.RB [ \-A \~\c
+.IR suffix-text "] \c"
+.I link-text
+.\" The link-text argument is not, presently, optional. See Savannah
+.\" #67916.
+.\" RI [ link-text ]
+Create a hotspot link to
+.I uri,
+a World Wide Web
+Universal Resource Identifer (URI).
+.
+.\" XXX: Nope--pdf.tmac formats "Unknown" as the link text instead. See
+.\" Savannah #67916.
+.\" If
+.\" .I link-text
+.\" is omitted,
+.\" .I uri
+.\" is formatted as the link text.
+.
+The
+.B \-P
+and
+.B \-A
+arguments format their successors as text
+before and after the link text,
+respectively,
+without intervening space.
+.
+Specifying
+.B \-S
+prevents
+.B pdfhref
+from \[lq]closing\[rq] the hotspot,
+requiring the document
+(or macro package wrapping
+.BR pdfhref )
+to do itself with
+.B \%pdfmarkend
+or
+.RB \[lq] "\[rs]X\[aq]pdf: markend\[aq]" \[rq].
+.
+.
+.TP
.\" XXX: We don't need to expose PDF's '/' syntax in a *roff macro
.\" file. It should prefix "field" with '/' itself. -- GBR
.BI ".pdfinfo /" "field content"\~\c
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
