2 .TH @G@SOELIM @MAN1EXT@ "@MDATE@" "groff @VERSION@"
4 @g@soelim \- interpret .so requests in groff input
7 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
13 .\" ====================================================================
15 .\" ====================================================================
17 .\" Copyright (C) 1989-2018 Free Software Foundation, Inc.
19 .\" Permission is granted to make and distribute verbatim copies of this
20 .\" manual provided the copyright notice and this permission notice are
21 .\" preserved on all copies.
23 .\" Permission is granted to copy and distribute modified versions of
24 .\" this manual under the conditions for verbatim copying, provided that
25 .\" the entire resulting derived work is distributed under the terms of
26 .\" a permission notice identical to this one.
28 .\" Permission is granted to copy and distribute translations of this
29 .\" manual into another language, under the above conditions for
30 .\" modified versions, except that this permission notice may be
31 .\" included in translations approved by the Free Software Foundation
32 .\" instead of in the original English.
35 .\" ====================================================================
37 .\" ====================================================================
47 .\" ====================================================================
49 .\" ====================================================================
54 and replaces lines of the form
61 It is useful if files included with
63 need to be preprocessed.
67 should be invoked with the
74 To embed \[oq]\[rs]\[cq] in the file name, write \[oq]\[rs]\[rs]\[cq]
77 To embed a space, write \[oq]\[rs]\ \[cq].
79 Any other escape sequence in
83 ignore the whole line.
87 Note that there must be no whitespace between the leading dot and the two
88 characters \[oq]s\[cq] and \[oq]o\[cq].
99 .\" ====================================================================
101 .\" ====================================================================
103 Whitespace is permitted between a command-line option and its argument.
110 even when followed by a character other than space or newline.
114 This option may be used to add a directory to the search path for
115 files (both those on the command line and those named in
119 The search path is initialized with the current directory.
121 This option may be specified more than once; the directories are then
122 searched in the order specified (but before the current directory).
124 If you want to make the current directory be read before other
127 at the appropriate place.
130 No directory search is performed for files with an absolute file name.
136 requests (for general use, with non-groff files).
142 requests but TeX comment lines (starting with \[oq]%\[cq]) giving the
143 current file and line number.
147 Print the version number.
150 .\" ====================================================================
152 .\" ====================================================================
154 The normal processing sequence of groff is this:
162 box invisible width 0.5 height 0.4 "input" "file";
163 move to last box .bottom;
166 box invisible width 0.8 height 0.2 "preprocessor";
167 move to last box .right
170 A: box invisible width 0.35 height 0.2 "troff";
171 move to last box .top;
174 box invisible width 0.6 height 0.4 "sourced" "file";
175 line <- up 0.3 from A.top;
179 box invisible width 0.85 height 0.2 "postprocessor";
180 move to last box .bottom;
183 box invisible width 0.5 height 0.4 "output" "file"
194 preprocessor -> troff -> postprocessor
203 That is, files sourced with
209 (the actual formatter).
220 If a file to be sourced should also be preprocessed, it must already be read
222 the input file passes through the preprocessor.
232 box invisible width 0.5 height 0.4 "input" "file";
233 move to last box .bottom;
236 A: box invisible width 0.5 height 0.2 "soelim";
238 box invisible width 0.5 height 0.4 "sourced" "file";
242 box invisible width 0.8 height 0.2 "preprocessor";
244 box invisible width 0.35 height 0.2 "troff";
246 box invisible width 0.85 height 0.2 "postprocessor";
247 move to last box .bottom;
250 box invisible width 0.5 height 0.4 "output" "file"
261 soelim -> preprocessor -> troff -> postprocessor
270 .\" ====================================================================
272 .\" ====================================================================
273 .BR groff (@MAN1EXT@)
276 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
283 .\" vim: set filetype=groff: