summaryrefslogtreecommitdiffstats
path: root/doc/groff.html.node/The-Implicit-Page-Trap.html
blob: 82d1a6b9da379e501a128d8bb09d92fdb809f551 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<!DOCTYPE html>
<html>
<!-- Created by GNU Texinfo 7.0.3, https://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<!-- This manual documents GNU troff version 1.23.0.

Copyright � 1994-2023 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled "GNU Free
Documentation License". -->
<title>The Implicit Page Trap (The GNU Troff Manual)</title>

<meta name="description" content="The Implicit Page Trap (The GNU Troff Manual)">
<meta name="keywords" content="The Implicit Page Trap (The GNU Troff Manual)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta name="viewport" content="width=device-width,initial-scale=1">

<link href="index.html" rel="start" title="Top">
<link href="Request-Index.html" rel="index" title="Request Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Vertical-Position-Traps.html" rel="up" title="Vertical Position Traps">
<link href="Diversion-Traps.html" rel="next" title="Diversion Traps">
<link href="Page-Location-Traps.html" rel="prev" title="Page Location Traps">


</head>

<body lang="en">
<div class="subsubsection-level-extent" id="The-Implicit-Page-Trap">
<div class="nav-panel">
<p>
Next: <a href="Diversion-Traps.html" accesskey="n" rel="next">Diversion Traps</a>, Previous: <a href="Page-Location-Traps.html" accesskey="p" rel="prev">Page Location Traps</a>, Up: <a href="Vertical-Position-Traps.html" accesskey="u" rel="up">Vertical Position Traps</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Request-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h4 class="subsubsection" id="The-Implicit-Page-Trap-1">5.28.1.2 The Implicit Page Trap</h4>
<a class="index-entry-id" id="index-implicit-trap"></a>
<a class="index-entry-id" id="index-trap_002c-implicit"></a>

<a class="index-entry-id" id="index-page-break-2"></a>
<a class="index-entry-id" id="index-break_002c-page-2"></a>
<a class="index-entry-id" id="index-page-ejection-2"></a>
<a class="index-entry-id" id="index-ejection_002c-page-2"></a>
<p>If, after starting GNU <code class="code">troff</code> without loading a macro package, you
use the <code class="code">ptr</code> request to dump a list of the active traps to the
standard error stream,<a class="footnote" id="DOCF109" href="groff.html_fot.html#FOOT109"><sup>109</sup></a>  nothing is reported.
Yet the <code class="code">.t</code> register will report a steadily decreasing value with
every output line your document produces, and once the value of
<code class="code">.t</code> gets to within <code class="code">.V</code> of zero, you will notice that
something trap-like happens&mdash;the page is ejected, a new one begins, and
the value of <code class="code">.t</code> becomes large once more.
</p>
<p>This <em class="dfn">implicit page trap</em> always exists in the top-level
diversion;<a class="footnote" id="DOCF110" href="groff.html_fot.html#FOOT110"><sup>110</sup></a> it works like a trap in some
ways but not others.  Its purpose is to eject the current page and start
the next one.  It has no name, so it cannot be moved or deleted with
<code class="code">wh</code> or <code class="code">ch</code> requests.  You cannot hide it by placing another
trap at its location, and can move it only by redefining the page length
with <code class="code">pl</code>.  Its operation is suppressed when vertical page traps
are disabled with GNU <code class="code">troff</code>&rsquo;s <code class="code">vpt</code> request.
</p>

</div>



</body>
</html>