Annotation of mandoc/soelim.1, Revision 1.5
1.5 ! schwarze 1: .\" $Id: soelim.1,v 1.4 2017/03/18 19:56:01 schwarze Exp $
1.2 schwarze 2: .\"
1.1 schwarze 3: .\" Copyright (c) 2014 Baptiste Daroussin <bapt@FreeBSD.org>
4: .\" All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
14: .\"
15: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25: .\" SUCH DAMAGE.
26: .\"
1.5 ! schwarze 27: .Dd $Mdocdate: March 18 2017 $
1.1 schwarze 28: .Dt SOELIM 1
29: .Os
30: .Sh NAME
31: .Nm soelim
1.3 schwarze 32: .Nd interpret .so requests in manpages
1.1 schwarze 33: .Sh SYNOPSIS
34: .Nm
35: .Op Fl Crtv
36: .Op Fl I Ar dir
37: .Op Ar files ...
38: .Sh DESCRIPTION
39: .Nm
40: reads
41: .Ar files
42: lines by lines.
43: .Pp
44: If a line starts by:
45: .Dq .so anotherfile
46: it replace the line by processing
47: .Dq anotherfile .
48: Otherwise the line is printed to stdout.
49: .Bl -tag -width "-I dir"
50: .It Fl C
51: Recognise
52: .Em .so
53: when not followed by a space character.
54: .It Fl r
55: Compatibility with GNU groff's
1.5 ! schwarze 56: .Nm soelim
1.1 schwarze 57: (does nothing).
58: .It Fl t
59: Compatibility with GNU groff's
1.5 ! schwarze 60: .Nm soelim
1.1 schwarze 61: (does nothing).
62: .It Fl v
63: Compatibility with GNU groff's
1.5 ! schwarze 64: .Nm soelim
1.1 schwarze 65: (does nothing).
66: .It Fl I Ar dir
67: This option specify directories where
68: .Nm
69: searches for files (both those on the command line and those named in
70: .Dq .so
71: directive.)
1.4 schwarze 72: This options may be specified multiple times.
73: The directories will be searched in the order specified.
1.1 schwarze 74: .El
75: .Pp
76: The files are always searched first in the current directory.
77: .Pp
78: A file specified with an absolute path will be opened directly without
79: performing a search.
80: .Sh SEE ALSO
1.3 schwarze 81: .Xr mandoc 1
82: .Sh AUTHORS
83: This version of the
84: .Nm
85: utility was written by
86: .An Baptiste Daroussin Aq Mt bapt@freebsd.org .
CVSweb