gropdf(1): Document pdfbookmark macro.

Continues fixing <https://savannah.gnu.org/bugs/?66453>.
This commit is contained in:
G. Branden Robinson 2026-01-15 20:05:50 -06:00
parent 9377ac54c5
commit 3c437538b4

View File

@ -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
.
.