soelim.man revision 75584 
1.ig \"-*- nroff -*-
2Copyright (C) 1989-2000 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.SH NAME
21@g@soelim \- interpret .so requests in groff input
22.SH SYNOPSIS
23.B @g@soelim
24[
25.B \-Cv
26]
27[
28.BI \-I dir
29]
30[
31.IR files \|.\|.\|.\|
32]
33.PP
34It is possible to have whitespace between the
35.B \-I
36command line option and its parameter.
37.SH DESCRIPTION
38.B @g@soelim
39reads
40.I files
41and replaces lines of the form
42.IP
43.BI .so\  file
44.LP
45by the contents of
46.IR file .
47It is useful if files included with
48.B so
49need to be preprocessed.
50Normally,
51.B @g@soelim
52should be invoked with the
53.B \-s
54option of
55.BR groff .
56.PP
57Note that there must be no whitespace between the leading dot and
58the two characters `s' and `o'.  Otherwise, only
59.B groff
60interprets the
61.B .so
62request (and
63.B soelim
64ignores it).
65.SH OPTIONS
66.TP
67.B \-C
68Recognize
69.B .so
70even when followed by a character other than space or newline.
71.TP
72.BI \-I dir
73This option may be used to specify a directory to search for
74files (both those on the command line and those named in
75.B \&.so
76lines).
77The current directory is always searched first.
78This option may be specified more than once,
79the directories will be searched in the order specified.
80No directory search is performed for files specified using an absolute path.
81.TP
82.B \-v
83Print the version number.
84.SH "SEE ALSO"
85.BR groff (@MAN1EXT@)
86