ZSOELIM(1)                   Manual pager utils                   ZSOELIM(1)

NAME         top

       zsoelim - satisfy .so requests in roff input

SYNOPSIS         top

       zsoelim [-CVh] [file ...]

DESCRIPTION         top

       zsoelim parses file arguments, or if none are specified, its standard
       input for lines of the form:

       .so <filename>

       These requests are replaced by the contents of the filename
       specified.  If the request cannot be met, zsoelim looks for
       filename.ext where .ext can be one of .gz, .Z or .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, 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.

OPTIONS         top

       -C, --compatible
              This flag is available for compatibility with other 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.

       -h, --help
              Print a help message and exit.

       -V, --version
              Display version information.

SEE ALSO         top

       groff(1), man(1), nroff(1), troff(1)

AUTHOR         top

       Wilf. (
       Fabrizio Polacco (
       Colin Watson (

COLOPHON         top

       This page is part of the man-db (manual pager suite) project.
       Information about the project can be found at 
       ⟨⟩.  If you have a bug report for this
       manual page, send it to  This page was
       obtained from the project's upstream Git repository 
       ⟨⟩ on 2017-09-15.  If you dis‐
       cover any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to                          2016-12-12                       ZSOELIM(1)

Pages that refer to this page: man(1)