Annotation of src/usr.bin/soelim/soelim.1, Revision 1.5
1.5 ! aaron 1: .\" $OpenBSD: soelim.1,v 1.4 1999/06/05 01:21:40 aaron Exp $
1.1 deraadt 2: .\" $NetBSD: soelim.1,v 1.3 1994/12/21 08:11:24 jtc Exp $
3: .\"
4: .\" Copyright (c) 1980, 1990, 1993
5: .\" The Regents of the University of California. All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
15: .\" 3. All advertising materials mentioning features or use of this software
16: .\" must display the following acknowledgement:
17: .\" This product includes software developed by the University of
18: .\" California, Berkeley and its contributors.
19: .\" 4. Neither the name of the University nor the names of its contributors
20: .\" may be used to endorse or promote products derived from this software
21: .\" without specific prior written permission.
22: .\"
23: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33: .\" SUCH DAMAGE.
34: .\"
35: .\" @(#)soelim.1 8.1 (Berkeley) 6/6/93
36: .\"
37: .Dd June 6, 1993
38: .Dt SOELIM 1
1.4 aaron 39: .Os
1.1 deraadt 40: .Sh NAME
41: .Nm soelim
42: .Nd eliminate \&.so's from nroff input
43: .Sh SYNOPSIS
44: .Nm soelim
45: .Op Ar file ...
46: .Sh DESCRIPTION
1.5 ! aaron 47: .Nm
1.1 deraadt 48: reads the specified files or the standard input and performs the textual
49: inclusion implied by the
50: .Xr nroff 1
51: directives of the form:
52: .Pp
53: .Dl \&.so somefile
54: .Pp
55: The directives need to appear at the beginning of input lines.
56: This is useful since programs such as
57: .Xr tbl 1
58: do not normally do this; it allows the placement of individual tables
59: in separate files to be run as a part of a large document.
60: .Pp
61: An argument consisting of a single minus
1.5 ! aaron 62: .Pq Ql -
1.1 deraadt 63: is taken to be
64: a file name corresponding to the standard input.
65: .Pp
1.5 ! aaron 66: Inclusion can be suppressed by using
1.1 deraadt 67: .Ql \e'
68: instead of
69: .Ql \e. ,
1.5 ! aaron 70: i.e.,
1.1 deraadt 71: .Pp
72: .Dl \'so /usr/lib/tmac.s
73: .Pp
74: A sample usage of
1.5 ! aaron 75: .Nm
1.1 deraadt 76: would be
77: .Pp
78: .Bd -literal -offset indent -compact
79: soelim exum?.n \&| tbl \&| nroff \-ms \&| col \&| lpr
80: .Ed
81: .Sh SEE ALSO
82: .Xr colcrt 1 ,
83: .Xr more 1
84: .Sh BUGS
1.5 ! aaron 85: The format of the source commands must involve no strangeness;
1.1 deraadt 86: exactly one blank must precede and no blanks follow the file name.
87: .Sh HISTORY
88: The
89: .Nm
90: command appeared in
91: .Bx 3.0 .