soelim(1)

soelim1

Interpret .so requests in manpages

Usage

soelim [-Crtv] [-I dir] [file ...]

Overview

The soelim utility reads the specified files or the standard input and performs the textual inclusion implied by the nroff(1) (ports/textproc/groff) directives of the form:

.so anotherfile

If a line starts with: “.so anotherfile” it replaces the line by processing “anotherfile”. Otherwise the line is printed to stdout.

-C

Recognise .so when it is not followed by a space character.

-r

Compatibility with groff's soelim(1) (does nothing).

-t

Compatibility with groff's soelim(1) (does nothing).

-v

Compatibility with groff's soelim(1) (does nothing).

-I dir

This option specifies directories where soelim searches for files (both those on the command line and those named in “.so” directive.) This option may be specified multiple times. The directories will be searched in the order specified.

The files are always searched first in the current directory.

A file specified with an absolute path will be opened directly without performing a search.

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 33 times.

  1. 2.0.5–2.2.2
  2. 2.2.5–3.5.1
  3. 4.0–4.3
  4. 4.4–4.6.2
  5. 4.7
  6. 4.8–4.11
  7. 5.0
  8. 5.1–6.0
  9. 6.1–6.4
  10. 7.0–8.3
  11. 8.4
  12. 9.0
  13. 9.1
  14. 9.2
  15. 9.3
  16. 10.0
  17. 10.1
  18. 10.2
  19. 10.3
  20. 10.4
  21. 11.0
  22. 11.1
  23. 11.2
  24. 11.3
  25. 11.4
  26. 12.0
  27. 12.1
  28. 12.2
  29. 12.3
  30. 12.4
  31. 13.0–13.2
  32. 13.3–13.5
  33. 14.0–15.1
  34. 16.0

-C since FreeBSD 5.0-RELEASE; -I since FreeBSD 5.0-RELEASE; -r since FreeBSD 5.1-RELEASE; -t since FreeBSD 5.1-RELEASE; -v since FreeBSD 5.0-RELEASE.

Authors

This version of the soelim utility was written by Baptiste Daroussin ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.