From b956dbf7f4d619e4e42b75411d53d6225019d559 Mon Sep 17 00:00:00 2001
From: "G. Branden Robinson" <g.branden.robinson@gmail.com>
Date: Thu, 15 Jan 2026 20:05:50 -0600
Subject: [PATCH] gropdf(1): Document `pdfhref` macro with `L` arg.

Continues fixing <https://savannah.gnu.org/bugs/?66453>.
---
 src/devices/gropdf/gropdf.1.man | 51 +++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 41b37d7c9..542090728 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -1683,6 +1683,57 @@ making the page location eligible as a target named by
 .
 .
 .TP
+.BR ".pdfhref L" \~\c
+.BI \-D\~ dest\~\c
+.RB [ \-S ] \~\c
+.RB [ \-P \~\c
+.IR prefix-text "] \c"
+.RB [ \-A \~\c
+.IR suffix-text "] \c"
+.RI [ link-text ]
+Create a hotspot link to
+.I dest,
+which a
+.RB \[lq] .pdfbookmark \~.\|.\|.\&\[rq]
+or
+.RB \[lq] ".pdfhref M" \~.\|.\|.\&\[rq]
+call elsewhere in the document should define.
+.
+(If the document employs forward references,
+it must be processed twice;
+see
+.MR pdfmom @MAN1EXT@ .)
+.
+If
+.I link-text
+is omitted,
+.I dest
+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
 .BR ".pdfhref M" \~\c
 .RB [ \-E ]\~\c
 .RB [ \-N \~\c