ZSOELIM(1)

📦
version 2.13.1 · 5 versions
, in alpine 3.24, arch rolling, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 ZSOELIM(1) 💖

Hey bestie, meet zsoelim ✨ It's the manual pager utils crew's little helper for satisfying .so requests in roff input 🧚

🌸 NAME 🌸

zsoelim — satisfy .so requests in roff input 💅

🎀 SYNOPSIS 🎀

zsoelim [-CVh] [file ...]

🦋 DESCRIPTION 🦋

okay so zsoelim goes through the file arguments you give it, or if you don't give it any, it reads from standard input 👀 It's looking for lines that look like this:

.so <filename>

Whenever it finds one, that request gets swapped out for the contents of the filename you named 🫶

Now the plot twist 😭 If that file doesn't exist, zsoelim doesn't just give up. It looks for filename.ext, where .ext can be .gz, .Z or .z. Other extensions might also work, depending on what options it was compiled with 🔥 And if it finds a compressed file that way, it decompresses it with the right decompressor and uses the output to fill in the request. Iconic, honestly 👑

Traditionally, soelim programs existed so roff preprocessors could also preprocess the files that the requests point to. This particular version was made to get around the problems caused by supporting compressed manual pages 💜

✨ OPTIONS ✨

  • -C, --compatible — this one's just here for compatibility with other soelim programs 🧚 It turns on .so requests followed by something other than whitespace. That's already the default, so it's literally ignored 💀
  • -h, --help — prints a help message and exits 🌈
  • -V, --version — shows version information 🍓

🌷 SEE ALSO 🌷

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

🫶 AUTHOR 🫶

Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Colin Watson (cjwatson@debian.org).

🐛 BUGS 🐛

Bug reports go to these places, so you know where to send your complaints 🙈

Bestie, that's the whole tea ☕ zsoelim is version 2.13.1, dated 2025-05-02, and it's an ZSOELIM(1) page through and through 💖 Stay iconic 💅✨

📦 where this page comes from