/usr/share/doc/groff-base/html/pic-15.html is in groff 1.22.3-7.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!-- Creator : groff version 1.22.3 -->
<!-- CreationDate: Thu Jan 28 14:57:16 2016 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>pic-15.html</title>
</head>
<hr>
[ <a href="pic-14.html">prev</a> | <a href="pic-16.html">next</a> | <a href="pic.html">top</a> ]
<hr>
<h2>15. Import/Export Commands
<a name="15. Import/Export Commands"></a>
</h2>
<p style="margin-top: 1em"><font color="#000000">Commands
that import or export data between <b>pic</b> and its
environment are described here.</font></p>
<h3>15.1. File and Table Insertion
<a name="15.1. File and Table Insertion"></a>
</h3>
<p style="margin-top: 1em"><font color="#000000">The
statement</font></p>
<p style="margin-left:10%; margin-top: 1em"><font color="#000000"><tt>copy</tt>
<i>filename</i></font></p>
<p style="margin-top: 1em"><font color="#000000">inserts
the contents of <i>filename</i> in the <b>pic</b> input
stream. Any <b>.PS</b>/<b>.PE</b> pair in the file is
ignored. You can use this to include pre-generated
images.</font></p>
<p style="margin-top: 1em"><font color="#000000">A variant
of this statement replicates the <b>copy thru</b> feature of
<i>grap</i>(1). The call</font></p>
<p style="margin-left:10%; margin-top: 1em"><font color="#000000"><tt>copy</tt>
<i>filename</i> <tt>thru</tt> <i>macro</i></font></p>
<p style="margin-top: 1em"><font color="#000000">calls
<i>macro</i> (which may be either a name or replacement
text) on the arguments obtained by breaking each line of the
file into blank-separated fields. The macro may have up to
9 arguments. The replacement text may be delimited by
braces or by a pair of instances of any character not
appearing in the rest of the text.</font></p>
<p style="margin-top: 1em"><font color="#000000">If you
write</font></p>
<p style="margin-left:10%; margin-top: 1em"><font color="#000000"><tt>copy
thru</tt> <i>macro</i></font></p>
<p style="margin-top: 1em"><font color="#000000">omitting
the filename, lines to be parsed are taken from the input
source up to the next <b>.PE</b>.</font></p>
<p style="margin-top: 1em"><font color="#000000">In either
of the last two <b>copy</b> commands, GNU <b>gpic</b>
permits a trailing ‘<b>until</b> <i>word</i>’
clause to be added which terminates the copy when the first
word matches the argument (the default behavior is therefore
equivalent to <b>until .PE</b>).</font></p>
<p style="margin-top: 1em"><font color="#000000">Accordingly,
the command</font></p>
<pre style="margin-left:20%; margin-top: 1em">.PS
copy thru % circle at ($1,$2) % until "END"
1 2
3 4
5 6
END
box
.PE</pre>
<p style="margin-top: 1em"><font color="#000000">is
equivalent to</font></p>
<pre style="margin-left:20%; margin-top: 1em">.PS
circle at (1,2)
circle at (3,4)
circle at (5,6)
box
.PE</pre>
<h3>15.2. Debug Messages
<a name="15.2. Debug Messages"></a>
</h3>
<p style="margin-top: 1em"><font color="#000000">The
command <b>print</b> accepts any number of arguments,
concatenates their output forms, and writes the result to
standard error. Each argument must be an expression, a
position, or a text string.</font></p>
<h3>15.3. Escape to Post-Processor
<a name="15.3. Escape to Post-Processor"></a>
</h3>
<p style="margin-top: 1em"><font color="#000000">If you
write</font></p>
<p style="margin-left:10%; margin-top: 1em"><font color="#000000"><b>command</b>
<i>arg</i>...</font></p>
<p style="margin-top: 1em"><font color="#000000"><b>pic</b>
concatenates the arguments and pass them through as a line
to troff or TeX. Each <i>arg</i> must be an expression, a
position, or text. This has a similar effect to a line
beginning with <b>.</b> or <b>\</b>, but allows the values
of variables to be passed through.</font></p>
<p style="margin-top: 1em"><font color="#000000">For
example,</font></p>
<pre style="margin-left:10%; margin-top: 1em">.PS
x = 14
command ".ds string x is " x "."
.PE
\*[string]</pre>
<p style="margin-top: 1em"><font color="#000000">prints</font></p>
<pre style="margin-left:10%; margin-top: 1em">x is 14.</pre>
<h3>15.4. Executing Shell Commands
<a name="15.4. Executing Shell Commands"></a>
</h3>
<p style="margin-top: 1em"><font color="#000000">The
command</font></p>
<p style="margin-left:10%; margin-top: 1em"><font color="#000000"><tt>sh
{</tt> <i>anything...</i> <tt>}</tt></font></p>
<p style="margin-top: 1em"><font color="#000000">macro-expands
the text in braces, then executes it as a shell command.
This could be used to generate images or data tables for
later inclusion. The delimiters shown as {} here may also be
two copies of any one character not present in the shell
command text. In either case, the body may contain balanced
{} pairs. Strings in the body may contain balanced or
unbalanced braces in any case.</font></p>
<hr>
[ <a href="pic-14.html">prev</a> | <a href="pic-16.html">next</a> | <a href="pic.html">top</a> ]
<hr>
|