# soelim(1) - man - phpMan

[SOELIM(1)](https://www.chedong.com/phpMan.php/man/SOELIM/1/markdown)                              General Commands Manual                             [SOELIM(1)](https://www.chedong.com/phpMan.php/man/SOELIM/1/markdown)



## NAME
       soelim - interpret .so requests in groff input

## SYNOPSIS
       **soelim** [**-Crtv**] [**-I** _dir_] [_file_ ...]

## DESCRIPTION
       **soelim** reads _files_ and replaces lines of the form

              **.so** _file_

       by  the  contents  of _file_.  It is useful if files included with **.so** need to be preprocessed.
       Normally, **soelim** should be invoked with the **-s** option of **groff**.

       To embed ‘\’ in the file name, write ‘\\’ or ‘\e’.  To embed a space, write ‘\ ’.  Any  other
       escape sequence in _file_ makes **soelim** ignore the whole line.

       Note  that there must be no whitespace between the leading dot and the two characters ‘s’ and
       ‘o’.  Otherwise, only **groff** interprets the **.so** request (and **soelim** ignores it).

## OPTIONS
       Whitespace is permitted between a command-line option and its argument.

### -C

### -I
              the  command  line  and  those named in **.so** requests).  The search path is initialized
              with the current directory.  This option may be specified more than once; the directo‐
              ries  are then searched in the order specified (but before the current directory).  If
              you want to make the current directory be read before other directories,  add  **-I.**  at
              the appropriate place.

              No directory search is performed for files with an absolute file name.

### -r

### -t
              file and line number.

### -v

## USAGE
       The normal processing sequence of groff is this:

                 input        sourced
                 file          file
                   |             |
                   v             v
               preprocessor -> troff -> postprocessor
                                             |
                                             v
                                          output
                                           file

       That is, files sourced with **.so** are normally read _only_ by **troff** (the actual formatter).  **soe**‐‐
       **lim** is _not_ required for **troff** to source files.

       If a file to be sourced should also be preprocessed, it must already be read _before_ the input
       file passes through the preprocessor.  This is handled by **soelim**:

                 input
                 file
                   |
                   v
                 soelim -> preprocessor -> troff -> postprocessor
                   ^                                     |
                   |                                     v
                sourced                               output
                 file                                  file

## SEE ALSO
       [**groff**(1)](https://www.chedong.com/phpMan.php/man/groff/1/markdown)



groff 1.22.4                                23 March 2022                                  [SOELIM(1)](https://www.chedong.com/phpMan.php/man/SOELIM/1/markdown)