1 '\" p -- preprocess: pic(1)
5 Copyright (c) 2014 - 2015 Steffen (Daode) Nurpmeso <sdaoden@users.sf.net>.
7 Copyright (C) 1989 - 2001, 2003, 2004, 2006, 2008
8 Free Software Foundation, Inc.
10 Permission is granted to make and distribute verbatim copies of
11 this manual provided the copyright notice and this permission notice
12 are preserved on all copies.
14 Permission is granted to copy and distribute modified versions of this
15 manual under the conditions for verbatim copying, provided that the
16 entire resulting derived work is distributed under the terms of a
17 permission notice identical to this one.
19 Permission is granted to copy and distribute translations of this
20 manual into another language, under the above conditions for modified
21 versions, except that this permission notice may be included in
22 translations approved by the Free Software Foundation instead of in
28 .TH @U_P_SOELIM@ @MAN1EXT@ "@MDATE@" "@T_ROFF@ v@VERSION@"
33 @L_P_SOELIM@ \- interpret .so requests in @T_ROFF@ input
46 It is possible to have whitespace between the
48 command line option and its parameter.
56 and replaces lines of the form
62 It is useful if files included with
64 need to be preprocessed.
67 should be invoked with the
73 To embed `\[rs]' in the file name, write `\[rs]\[rs]' or `\[rs]e'.
74 To embed a space, write `\[rs]\ '.
75 Any other escape sequence in
79 ignore the whole line.
82 Note that there must be no whitespace between the leading dot and the two
83 characters `s' and `o'.
99 even when followed by a character other than space or newline.
103 This option may be used to add a directory to the search path for files
104 (both those on the command line and those named in
107 The search path is initialized with the current directory.
108 This option may be specified more than once; the directories are then
109 searched in the order specified (but before the current directory).
110 If you want to make the current directory be read before other directories,
113 at the appropriate place.
115 No directory search is performed for files with an absolute file name.
121 requests (for general use, with non-roff files).
127 requests but TeX comment lines (starting with `%') giving the current file
132 Print the version number.
137 The normal processing sequence of @T_ROFF@ is this:
144 box invisible width 0.5 height 0.4 "input" "file";
145 move to last box .bottom;
148 box invisible width 0.8 height 0.2 "preprocessor";
149 move to last box .right
152 A: box invisible width 0.35 height 0.2 "troff";
153 move to last box .top;
156 box invisible width 0.6 height 0.4 "sourced" "file";
157 line <- up 0.3 from A.top;
161 box invisible width 0.85 height 0.2 "postprocessor";
162 move to last box .bottom;
165 box invisible width 0.5 height 0.4 "output" "file"
176 preprocessor -> troff -> postprocessor
185 That is, files sourced with
191 (the actual formatter).
200 If a file to be sourced should also be preprocessed, it must already be read
202 the input file passes through the preprocessor.
211 box invisible width 0.5 height 0.4 "input" "file";
212 move to last box .bottom;
215 A: box invisible width 0.5 height 0.2 "soelim";
217 box invisible width 0.5 height 0.4 "sourced" "file";
221 box invisible width 0.8 height 0.2 "preprocessor";
223 box invisible width 0.35 height 0.2 "troff";
225 box invisible width 0.85 height 0.2 "postprocessor";
226 move to last box .bottom;
229 box invisible width 0.5 height 0.4 "output" "file"
240 soelim -> preprocessor -> troff -> postprocessor
251 .BR @L_ROFF@ (@MAN1EXT@)