Commit: afdfa353df9931623bbacb08290bb3227327594d - groff-pdfmark (hg)

Reference Documentation: PDF Publishing with GNU Troff

Commit MetaInfo

• Revision: afdfa353df9931623bbacb08290bb3227327594d (tree)
• Time: 2024-06-14 18:47:45
• Author: Keith Marshall <keith@user...>
• Commiter: Keith Marshall

Log Message

Correct manpage page trap and end macro handling.

* tmac/anpdf.tmac (anpdf-atend): New macro; assign it...
(anpdf-reload-man): ...here, as end macro replacement for...
(an-end): ...this default groff_man(7) internal end macro.
(anpdf-reload-man): Append groff_pdfhref(7) page trap handler to...
(PT): ...this groff_man(7) page trap hook.

Change Summary

• modified: tmac/anpdf.tmac

Incremental Difference

diff -r 6561c094adf2 -r afdfa353df99 tmac/anpdf.tmac
--- a/tmac/anpdf.tmac	Tue Jun 11 14:00:23 2024 +0100
+++ b/tmac/anpdf.tmac	Fri Jun 14 10:47:45 2024 +0100
@@ -118,7 +118,15 @@
 .\"
 .   anpdf-pdfsync O
 .   als anpdf-pdfsync pdfsync
-.   em anpdf-pdfsync
+.   em anpdf-atend
+.
+.\" We also need to install a page trap handler, to ensure that
+.\" any links which span page breaks are correctly mapped; it is
+.\" convenient to attach this to groff_man's existing PT handler,
+.\" but this will be redefined every time reload-man is called,
+.\" so we must reattach our handler every time.
+.\"
+.   pdfhref I -PT PT
 .
 .\" If TH is called again, ensure that we intercept it; (we must
 .\" not allow reload-man to get immediate control, which it will
@@ -137,6 +145,14 @@
 .\"
 .de anpdf-pdfsync
 ..
+.\" anpdf-pdfsync must be called by the active end-of-input macro;
+.\" anpdf-atend is assigned, overriding but then encapsulating the
+.\" default an-end macro, to achieve the required objective.
+.\"
+.de1 anpdf-atend
+.   anpdf-pdfsync
+.   an-end
+..
 .
 .\" PDF Document Outlines
 .\" ---------------------