summaryrefslogtreecommitdiffstats
path: root/man/man1/zsoelim.man1
diff options
context:
space:
mode:
Diffstat (limited to 'man/man1/zsoelim.man1')
-rw-r--r--man/man1/zsoelim.man184
1 files changed, 84 insertions, 0 deletions
diff --git a/man/man1/zsoelim.man1 b/man/man1/zsoelim.man1
new file mode 100644
index 0000000..599e46e
--- /dev/null
+++ b/man/man1/zsoelim.man1
@@ -0,0 +1,84 @@
+.\" Man page for %zsoelim%
+.\"
+.\" Copyright (C), 1994, 1995, Graeme W. Wilford. (Wilf.)
+.\"
+.\" You may distribute under the terms of the GNU General Public
+.\" License as specified in the file docs/COPYING.GPLv2 that comes with the
+.\" man-db distribution.
+.\"
+.\" Sat Dec 10 19:33:32 GMT 1994 Wilf. (G.Wilford@ee.surrey.ac.uk)
+.\"
+.pc
+.TH %thzsoelim% 1 "%date%" "%version%" "Manual pager utils"
+.SH NAME
+%zsoelim% \- satisfy .so requests in roff input
+.SH SYNOPSIS
+.B %zsoelim%
+.RB [\| \-CVh \|]
+.RI [\| file
+\&.\|.\|.\|]
+.SH DESCRIPTION
+.B %zsoelim%
+parses
+.I file
+arguments, or if none are specified, its standard input for lines of the
+form:
+
+.B .so
+.RI <\| filename \|>
+
+These requests are replaced by the contents of the
+.I filename
+specified.
+If the request cannot be met,
+.B %zsoelim%
+looks for
+.I filename.ext
+where
+.I .ext
+can be one of
+.BR .gz ,
+.B .Z
+or
+.BR .z .
+Other extension types may be supported depending upon compile time options.
+If the request can be met by a compressed file, this file is decompressed
+using an appropriate decompressor and its output is used to satisfy
+the request.
+
+Traditionally,
+.B soelim
+programs were used to allow roff preprocessors to be able to preprocess the
+files referred to by the requests.
+This particular version was written to circumvent problems created by
+support for compressed manual pages.
+.SH OPTIONS
+.TP
+.if !'po4a'hide' .BR \-C ", " \-\-compatible
+This flag is available for compatibility with other
+.B soelim
+programs.
+Its use is to enable .so requests followed by something other than
+whitespace.
+As this is already the default behaviour, it is ignored.
+.TP
+.if !'po4a'hide' .BR \-h ", " \-\-help
+Print a help message and exit.
+.TP
+.if !'po4a'hide' .BR \-V ", " \-\-version
+Display version information.
+.SH "SEE ALSO"
+.if !'po4a'hide' .BR groff (1),
+.if !'po4a'hide' .BR %man% (1),
+.if !'po4a'hide' .BR nroff (1),
+.if !'po4a'hide' .BR troff (1)
+.SH AUTHOR
+.nf
+.if !'po4a'hide' Wilf.\& (G.Wilford@ee.surrey.ac.uk).
+.if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org).
+.if !'po4a'hide' Colin Watson (cjwatson@debian.org).
+.fi
+.SH BUGS
+.if !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues
+.br
+.if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db