NAME    [Toc]    [Back]

       soelim - Processes .so requests in nroff input

SYNOPSIS    [Toc]    [Back]

       soelim [file...]

DESCRIPTION    [Toc]    [Back]

       The  soelim  command reads the specified files or standard
       input and performs the textual inclusion implied by  nroff
       requests of the form:

       .so file

       When these requests appear at the beginning of input lines
       (see SEE ALSO).  This is useful since commands such as tbl
       do  not  normally  do  this; the soelim command allows the
       placement of individual tables in separate files to be run
       as  a part of a large document.  The original and included
       text are written to the standard output.

       Note that exactly one space must precede and no spaces can
       follow  the  filename.  A flag consisting of a - (dash) is
       taken to be a filename corresponding  to  standard  input.
       Inclusion  can  be  suppressed by using a ' (single quote)
       instead of a . (dot) as follows: 'so /usr/share/lib/tmac.s

EXAMPLES    [Toc]    [Back]

       In  the  following  example, the soelim command is used to
       preprocess file inclusion (.so) requests: soelim exum?.n |
       tbl | nroff -ms

       Because  the  tbl  command  does  not  process  the  nroff
       requests, the soelim command is used to  preprocess  them.
       The output is then passed to the tbl command.  This facilitates
 the placement of tables in separate files that  can
       be included to form a large document.

SEE ALSO    [Toc]    [Back]

       Commands:  colcrt(1), neqn(1), nroff(1), tbl(1)



                                                        soelim(1)