gbranden pushed a commit to branch master
in repository groff.
commit 3c437538b4b8f6797d2d59890606b69f41255cab
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jan 15 20:05:50 2026 -0600
gropdf(1): Document `pdfbookmark` macro.
Continues fixing <https://savannah.gnu.org/bugs/?66453>.
---
src/devices/gropdf/gropdf.1.man | 28 ++++++++++++++++++++++++++++
1 file changed, 28 insertions(+)
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index dd5abfd90..bf572dc4b 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -1654,6 +1654,34 @@ Some features have no direct device extension escape
sequence
counterpart.
.
.
+.TP
+.BR ".pdfbookmark " [ \-T\~\c
+.IR tag-name ]\~ "level text"
+Mark the nearest page location as a bookmark,
+and optionally a named destination as well.
+.
+.I Bookmarks
+populate the outline pane of the reader.
+.
+They are organized into a hierarchical tree;
+each level of the tree is numbered,
+starting at 1,
+and named as
+.I text
+in the outline.
+.
+.I "Named destinations"
+permit hyperlink-style navigation within the document.
+.
+Specifying
+.B \-T
+followed by
+.I tag-name
+creates a named destination
+making the page location eligible as a target named by
+.RB \[lq] ".pdfhref L" \~.\|.\|.\&\[rq].
+.
+.
.\" pdfhref
.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
