xref: /original-bsd/usr.bin/soelim/soelim.1 (revision 48d2e7c6)
1.\" Copyright (c) 1980, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)soelim.1	6.4 (Berkeley) 04/22/91
7.\"
8.Dd
9.Dt SOELIM 1
10.Os BSD 3
11.Sh NAME
12.Nm soelim
13.Nd eliminate \&.so's from nroff input
14.Sh SYNOPSIS
15.Nm soelim
16.Op Ar file ...
17.Sh DESCRIPTION
18.Nm Soelim
19reads the specified files or the standard input and performs the textual
20inclusion implied by the
21.Xr nroff 1
22directives of the form:
23.Pp
24.Dl \&.so somefile
25.Pp
26The directives need to appear at the beginning of input lines.
27This is useful since programs such as
28.Xr tbl 1
29do not normally do this; it allows the placement of individual tables
30in separate files to be run as a part of a large document.
31.Pp
32An argument consisting of a single minus
33.Ql Fl
34is taken to be
35a file name corresponding to the standard input.
36.Pp
37Note that inclusion can be suppressed by using
38.Ql \e'
39instead of
40.Ql \e. ,
41i.e.
42.Pp
43.Dl \'so /usr/lib/tmac.s
44.Pp
45A sample usage of
46.Nm soelim
47would be
48.Pp
49.Bd -literal -offset indent -compact
50soelim exum?.n \&| tbl \&| nroff \-ms \&| col \&| lpr
51.Ed
52.Sh SEE ALSO
53.Xr colcrt 1 ,
54.Xr more 1
55.Sh BUGS
56The format of the source commands must involve no strangeness \-
57exactly one blank must precede and no blanks follow the file name.
58.Sh HISTORY
59The
60.Nm
61command appeared in
62.Bx 3.0 .
63