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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
|
<!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>Device Control Commands (The GNU Troff Manual)</title>
<meta name="description" content="Device Control Commands (The GNU Troff Manual)">
<meta name="keywords" content="Device Control Commands (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="Command-Reference.html" rel="up" title="Command Reference">
<link href="Obsolete-Command.html" rel="next" title="Obsolete Command">
<link href="Graphics-Commands.html" rel="prev" title="Graphics Commands">
<style type="text/css">
<!--
div.display {margin-left: 3.2em}
pre.display-preformatted {font-family: inherit}
span.r {font-family: initial; font-weight: normal; font-style: normal}
-->
</style>
</head>
<body lang="en">
<div class="subsubsection-level-extent" id="Device-Control-Commands">
<div class="nav-panel">
<p>
Next: <a href="Obsolete-Command.html" accesskey="n" rel="next">Obsolete Command</a>, Previous: <a href="Graphics-Commands.html" accesskey="p" rel="prev">Graphics Commands</a>, Up: <a href="Command-Reference.html" accesskey="u" rel="up">Command Reference</a> [<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="Device-Control-Commands-1">6.1.2.4 Device Control Commands</h4>
<p>Each device control command starts with the letter ‘<samp class="samp">x</samp>’, followed by
a space character (optional or arbitrary space or tab in <code class="code">gtroff</code>)
and a subcommand letter or word; each argument (if any) must be preceded
by a syntactical space. All ‘<samp class="samp">x</samp>’ commands are terminated by a
syntactical line break; no device control command can be followed by
another command on the same line (except a comment).
</p>
<p>The subcommand is basically a single letter, but to increase
readability, it can be written as a word, i.e., an arbitrary sequence of
characters terminated by the next tab, space, or newline character. All
characters of the subcommand word but the first are simply ignored. For
example, <code class="code">gtroff</code> outputs the initialization command ‘<samp class="samp">x i</samp>’<!-- /@w -->
as ‘<samp class="samp">x init</samp>’<!-- /@w --> and the resolution command ‘<samp class="samp">x r</samp>’<!-- /@w --> as
‘<samp class="samp">x res</samp>’<!-- /@w -->.
</p>
<p>In the following, the syntax element ‹<span class="r">line break</span>› means a
syntactical line break (see <a class="pxref" href="Separation.html">Separation</a>).
</p>
<dl class="table">
<dt><code class="code">xF <var class="var">name</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">F</samp>’ stands for <var class="var">Filename</var>.
</p>
<p>Use <var class="var">name</var> as the intended name for the current file in error
reports. This is useful for remembering the original file name when
<code class="code">gtroff</code> uses an internal piping mechanism. The input file is not
changed by this command. This command is a <code class="code">gtroff</code> extension.
</p>
</dd>
<dt><code class="code">xf <var class="var">n</var> <var class="var">s</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">f</samp>’ stands for <var class="var">font</var>.
</p>
<p>Mount font position <var class="var">n</var> (a non-negative integer) with font
named <var class="var">s</var> (a text word). See <a class="xref" href="Font-Positions.html">Font Positions</a>.
</p>
</dd>
<dt><code class="code">xH <var class="var">n</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">H</samp>’ stands for <var class="var">Height</var>.
</p>
<p>Set glyph height to <var class="var">n</var> (a positive integer in scaled points
‘<samp class="samp">z</samp>’). <abbr class="acronym">AT&T</abbr> <code class="code">troff</code> uses the unit points (‘<samp class="samp">p</samp>’)
instead. See <a class="xref" href="Output-Language-Compatibility.html">Output Language Compatibility</a>.
</p>
</dd>
<dt><code class="code">xi‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">i</samp>’ stands for <var class="var">init</var>.
</p>
<p>Initialize device. This is the third command of the prologue.
</p>
</dd>
<dt><code class="code">xp‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">p</samp>’ stands for <var class="var">pause</var>.
</p>
<p>Parsed but ignored. The <abbr class="acronym">AT&T</abbr> <code class="code">troff</code> manual documents
this command as
</p>
<div class="display">
<pre class="display-preformatted">pause device, can be restarted
</pre></div>
<p>but GNU <code class="code">troff</code> output drivers do nothing with this command.
</p>
</dd>
<dt><code class="code">xr <var class="var">n</var> <var class="var">h</var> <var class="var">v</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">r</samp>’ stands for <var class="var">resolution</var>.
</p>
<p>Resolution is <var class="var">n</var>, while <var class="var">h</var> is the minimal horizontal
motion, and <var class="var">v</var> the minimal vertical motion possible with this
device; all arguments are positive integers in basic units ‘<samp class="samp">u</samp>’ per
inch. This is the second command of the prologue.
</p>
</dd>
<dt><code class="code">xS <var class="var">n</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">S</samp>’ stands for <var class="var">Slant</var>.
</p>
<p>Set slant to <var class="var">n</var> (an integer in basic units ‘<samp class="samp">u</samp>’).
</p>
</dd>
<dt><code class="code">xs‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">s</samp>’ stands for <var class="var">stop</var>.
</p>
<p>Terminates the processing of the current file; issued as the last
command of any intermediate <code class="code">troff</code> output.
</p>
</dd>
<dt><code class="code">xt‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">t</samp>’ stands for <var class="var">trailer</var>.
</p>
<p>Generate trailer information, if any. In GNU <code class="code">troff</code>, this is
ignored.
</p>
</dd>
<dt><code class="code">xT <var class="var">xxx</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">T</samp>’ stands for <var class="var">Typesetter</var>.
</p>
<p>Set the name of the output driver to <var class="var">xxx</var>, a sequence of
non-whitespace characters terminated by whitespace. The possible names
correspond to those of <code class="code">groff</code>’s <samp class="option">-T</samp> option. This is the
first command of the prologue.
</p>
</dd>
<dt><code class="code">xu <var class="var">n</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">u</samp>’ stands for <var class="var">underline</var>.
</p>
<p>Configure underlining of spaces. If <var class="var">n</var> is 1, start
underlining of spaces; if <var class="var">n</var> is 0, stop underlining of spaces.
This is needed for the <code class="code">cu</code> request in <code class="code">nroff</code> mode and is
ignored otherwise. This command is a <code class="code">gtroff</code> extension.
</p>
</dd>
<dt><code class="code">xX <var class="var">anything</var>‹<span class="r">line break</span>›</code></dt>
<dd><p>The ‘<samp class="samp">x</samp>’ stands for <var class="var">X-escape</var>.
</p>
<p>Send string <var class="var">anything</var> uninterpreted to the device. If the line
following this command starts with a ‘<samp class="samp">+</samp>’ character this line is
interpreted as a continuation line in the following sense. The ‘<samp class="samp">+</samp>’
is ignored, but a newline character is sent instead to the device, the
rest of the line is sent uninterpreted. The same applies to all
following lines until the first character of a line is not a ‘<samp class="samp">+</samp>’
character. This command is generated by the <code class="code">gtroff</code> escape
sequence <code class="code">\X</code>. The line-continuing feature is a <code class="code">gtroff</code>
extension.
</p></dd>
</dl>
</div>
<hr>
<div class="nav-panel">
<p>
Next: <a href="Obsolete-Command.html">Obsolete Command</a>, Previous: <a href="Graphics-Commands.html">Graphics Commands</a>, Up: <a href="Command-Reference.html">Command Reference</a> [<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>
</body>
</html>
|
