3 Copyright (C) 1989-2000, 2001, 2003, 2004, 2006, 2008, 2009
4 Free Software Foundation, Inc.
6 Permission is granted to make and distribute verbatim copies of
7 this manual provided the copyright notice and this permission notice
8 are preserved on all copies.
10 Permission is granted to copy and distribute modified versions of this
11 manual under the conditions for verbatim copying, provided that the
12 entire resulting derived work is distributed under the terms of a
13 permission notice identical to this one.
15 Permission is granted to copy and distribute translations of this
16 manual into another language, under the above conditions for modified
17 versions, except that this permission notice may be included in
18 translations approved by the Free Software Foundation instead of in
24 .TH @G@SOELIM @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
29 @g@soelim \- interpret .so requests in groff input
42 It is possible to have whitespace between the
44 command line option and its parameter.
52 and replaces lines of the form
58 It is useful if files included with
60 need to be preprocessed.
63 should be invoked with the
69 To embed `\[rs]' in the file name, write `\[rs]\[rs]' or `\[rs]e'.
70 To embed a space, write `\[rs]\ '.
71 Any other escape sequence in
75 ignore the whole line.
78 Note that there must be no whitespace between the leading dot and the two
79 characters `s' and `o'.
95 even when followed by a character other than space or newline.
99 This option may be used to add a directory to the search path for files
100 (both those on the command line and those named in
103 The search path is initialized with the current directory.
104 This option may be specified more than once; the directories are then
105 searched in the order specified (but before the current directory).
106 If you want to make the current directory be read before other directories,
109 at the appropriate place.
111 No directory search is performed for files with an absolute file name.
117 requests (for general use, with non-groff files).
123 requests but TeX comment lines (starting with `%') giving the current file
128 Print the version number.
133 The normal processing sequence of groff is this:
140 box invisible width 0.5 height 0.4 "input" "file";
141 move to last box .bottom;
144 box invisible width 0.8 height 0.2 "preprocessor";
145 move to last box .right
148 A: box invisible width 0.35 height 0.2 "troff";
149 move to last box .top;
152 box invisible width 0.6 height 0.4 "sourced" "file";
153 line <- up 0.3 from A.top;
157 box invisible width 0.85 height 0.2 "postprocessor";
158 move to last box .bottom;
161 box invisible width 0.5 height 0.4 "output" "file"
172 preprocessor -> troff -> postprocessor
181 That is, files sourced with
187 (the actual formatter).
196 If a file to be sourced should also be preprocessed, it must already be read
198 the input file passes through the preprocessor.
207 box invisible width 0.5 height 0.4 "input" "file";
208 move to last box .bottom;
211 A: box invisible width 0.5 height 0.2 "soelim";
213 box invisible width 0.5 height 0.4 "sourced" "file";
217 box invisible width 0.8 height 0.2 "preprocessor";
219 box invisible width 0.35 height 0.2 "troff";
221 box invisible width 0.85 height 0.2 "postprocessor";
222 move to last box .bottom;
225 box invisible width 0.5 height 0.4 "output" "file"
236 soelim -> preprocessor -> troff -> postprocessor
247 .BR groff (@MAN1EXT@)