summaryrefslogtreecommitdiffstats
path: root/doc/groff.html.node/The-Implicit-Page-Trap.html
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--doc/groff.html.node/The-Implicit-Page-Trap.html74
1 files changed, 74 insertions, 0 deletions
diff --git a/doc/groff.html.node/The-Implicit-Page-Trap.html b/doc/groff.html.node/The-Implicit-Page-Trap.html
new file mode 100644
index 0000000..82d1a6b
--- /dev/null
+++ b/doc/groff.html.node/The-Implicit-Page-Trap.html
@@ -0,0 +1,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>