3 .TH @G@SOELIM @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
5 @g@soelim \- interpret .so requests in groff input
10 Copyright \[co] 1989-2014 Free Software Foundation, Inc.
12 Permission is granted to make and distribute verbatim copies of
13 this manual provided the copyright notice and this permission notice
14 are preserved on all copies.
16 Permission is granted to copy and distribute modified versions of this
17 manual under the conditions for verbatim copying, provided that the
18 entire resulting derived work is distributed under the terms of a
19 permission notice identical to this one.
21 Permission is granted to copy and distribute translations of this
22 manual into another language, under the above conditions for modified
23 versions, except that this permission notice may be included in
24 translations approved by the Free Software Foundation instead of in
28 .\" --------------------------------------------------------------------
30 .\" --------------------------------------------------------------------
41 It is possible to have whitespace between the
43 command line option and its parameter.
46 .\" --------------------------------------------------------------------
48 .\" --------------------------------------------------------------------
53 and replaces lines of the form
60 It is useful if files included with
62 need to be preprocessed.
66 should be invoked with the
73 To embed \[oq]\[rs]\[cq] in the file name, write \[oq]\[rs]\[rs]\[cq]
76 To embed a space, write \[oq]\[rs]\ \[cq].
78 Any other escape sequence in
82 ignore the whole line.
86 Note that there must be no whitespace between the leading dot and the two
87 characters \[oq]s\[cq] and \[oq]o\[cq].
98 .\" --------------------------------------------------------------------
100 .\" --------------------------------------------------------------------
106 even when followed by a character other than space or newline.
110 This option may be used to add a directory to the search path for
111 files (both those on the command line and those named in
115 The search path is initialized with the current directory.
117 This option may be specified more than once; the directories are then
118 searched in the order specified (but before the current directory).
120 If you want to make the current directory be read before other
123 at the appropriate place.
126 No directory search is performed for files with an absolute file name.
132 requests (for general use, with non-groff files).
138 requests but TeX comment lines (starting with \[oq]%\[cq]) giving the
139 current file and line number.
143 Print the version number.
146 .\" --------------------------------------------------------------------
148 .\" --------------------------------------------------------------------
150 The normal processing sequence of groff is this:
158 box invisible width 0.5 height 0.4 "input" "file";
159 move to last box .bottom;
162 box invisible width 0.8 height 0.2 "preprocessor";
163 move to last box .right
166 A: box invisible width 0.35 height 0.2 "troff";
167 move to last box .top;
170 box invisible width 0.6 height 0.4 "sourced" "file";
171 line <- up 0.3 from A.top;
175 box invisible width 0.85 height 0.2 "postprocessor";
176 move to last box .bottom;
179 box invisible width 0.5 height 0.4 "output" "file"
190 preprocessor -> troff -> postprocessor
199 That is, files sourced with
205 (the actual formatter).
216 If a file to be sourced should also be preprocessed, it must already be read
218 the input file passes through the preprocessor.
228 box invisible width 0.5 height 0.4 "input" "file";
229 move to last box .bottom;
232 A: box invisible width 0.5 height 0.2 "soelim";
234 box invisible width 0.5 height 0.4 "sourced" "file";
238 box invisible width 0.8 height 0.2 "preprocessor";
240 box invisible width 0.35 height 0.2 "troff";
242 box invisible width 0.85 height 0.2 "postprocessor";
243 move to last box .bottom;
246 box invisible width 0.5 height 0.4 "output" "file"
257 soelim -> preprocessor -> troff -> postprocessor
266 .\" --------------------------------------------------------------------
268 .\" --------------------------------------------------------------------
269 .BR groff (@MAN1EXT@)
272 .\" --------------------------------------------------------------------
274 .\" --------------------------------------------------------------------