soelim.man revision 114402 
1.ig
2Copyright (C) 1989-2000, 2001, 2003 Free Software Foundation, Inc.
3
4Permission is granted to make and distribute verbatim copies of
5this manual provided the copyright notice and this permission notice
6are preserved on all copies.
7
8Permission is granted to copy and distribute modified versions of this
9manual under the conditions for verbatim copying, provided that the
10entire resulting derived work is distributed under the terms of a
11permission notice identical to this one.
12
13Permission is granted to copy and distribute translations of this
14manual into another language, under the above conditions for modified
15versions, except that this permission notice may be included in
16translations approved by the Free Software Foundation instead of in
17the original English.
18..
19.TH @G@SOELIM @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
20.
21.SH NAME
22@g@soelim \- interpret .so requests in groff input
23.
24.SH SYNOPSIS
25.B @g@soelim
26[
27.B \-Crtv
28]
29[
30.BI \-I dir
31]
32[
33.IR files \|.\|.\|.\|
34]
35.
36.PP
37It is possible to have whitespace between the
38.B \-I
39command line option and its parameter.
40.
41.SH DESCRIPTION
42.B @g@soelim
43reads
44.I files
45and replaces lines of the form
46.IP
47.BI .so\  file
48.LP
49by the contents of
50.IR file .
51It is useful if files included with
52.B so
53need to be preprocessed.
54Normally,
55.B @g@soelim
56should be invoked with the
57.B \-s
58option of
59.BR groff .
60.
61.PP
62Note that there must be no whitespace between the leading dot and
63the two characters `s' and `o'.  Otherwise, only
64.B groff
65interprets the
66.B .so
67request (and
68.B soelim
69ignores it).
70.
71.SH OPTIONS
72.TP
73.B \-C
74Recognize
75.B .so
76even when followed by a character other than space or newline.
77.
78.TP
79.BI \-I dir
80This option may be used to specify a directory to search for
81files (both those on the command line and those named in
82.B \&.so
83lines).
84The current directory is always searched first.
85This option may be specified more than once,
86the directories will be searched in the order specified.
87No directory search is performed for files specified using an absolute path.
88.
89.TP
90.B \-r
91Do not add .lf requests (for general use, with non-groff files).
92.
93.TP
94.B \-t
95Don't emit .lf requests but TeX comment lines (starting with `%') giving
96the current file and line number.
97.
98.TP
99.B \-v
100Print the version number.
101.
102.SH "SEE ALSO"
103.BR groff (@MAN1EXT@)
104.
105.\" Local Variables:
106.\" mode: nroff
107.\" End:
108