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