pdftex[836] branches/stable/doc/manual/pdftex-t.tex: add description

commits+thanh at tug.org commits+thanh at tug.org
Fri Jun 12 10:52:37 CEST 2020

Revision: 836
Author:   thanh
Date:     2020-06-12 10:52:37 +0200 (Fri, 12 Jun 2020)
Log Message:
add description of primitives \pdfrunninglinkoff & \pdfrunninglinkon to manual

Modified Paths:

Modified: branches/stable/doc/manual/pdftex-t.tex
--- branches/stable/doc/manual/pdftex-t.tex	2020-06-11 21:54:52 UTC (rev 835)
+++ branches/stable/doc/manual/pdftex-t.tex	2020-06-12 08:52:37 UTC (rev 836)
@@ -3926,6 +3926,35 @@
 on every run is just noise, and can be suppressed by setting this
 parameter to a positive number.  \introduced{1.40.13}
+These commands create corresponding whatsit nodes which turn on/off generation
+of running links. Typical usage is to turn off generation of running
+links in header or footer of a page. Generation of running links is
+on when the shipout routine begins.
+The generation of running links works roughly like this: \PDFTEX\ keeps
+a stack of links created by \type{\pdfstartlink}, called \type{pdf_link_stack}. When writing
+out an hbox to pdf, \PDFTEX\ checks if the nesting level of the box is the same
+as the nesting level of the top entry in \type{pdf_link_stack}; if yes that box would
+become a link, too.
+The whatsit nodes created by the above primitives will turn on/off a flag, which controls if a hbox being shipped can become a link (in addition to the condition described above).
+The commands must be inserted before the hbox in question. For example:
+% (1) good:
+  \hbox{this is a line that would become a link otherwise}
+% (2) bad:
+\hbox{\pdfrunninglinkoff this is a line that would become a link} 
+% too late; \pdfrunninglinkoff must be inserted before the box

More information about the pdftex-commits mailing list.