Rio Terminal Man Pages #

This directory contains manual pages for Rio terminal emulator in scdoc format.

Files #

• rio.1.scd - Main Rio terminal manual page (section 1)
• rio.5.scd - Rio configuration file format manual page (section 5)
• rio-bindings.5.scd - Rio key bindings manual page (section 5)

Building #

To build the man pages, you need scdoc installed:

Install scdoc #

macOS (Homebrew):

brew install scdoc

Ubuntu/Debian:

sudo apt install scdoc

Arch Linux:

sudo pacman -S scdoc

From source:

git clone https://git.sr.ht/~sircmpwn/scdoc
cd scdoc
make
sudo make install

Build man pages #

# Build all man pages
make -C extra/man

# Or build individually
scdoc < extra/man/rio.1.scd > rio.1
scdoc < extra/man/rio.5.scd > rio.5
scdoc < extra/man/rio-bindings.5.scd > rio-bindings.5

Install man pages #

# Install to system man directory (requires sudo)
sudo cp rio.1 /usr/local/share/man/man1/
sudo cp rio.5 /usr/local/share/man/man5/
sudo cp rio-bindings.5 /usr/local/share/man/man5/

# Update man database
sudo mandb

View man pages #

man rio
man 5 rio
man 5 rio-bindings

Format #

The man pages are written in scdoc format, which is a simple markup language for writing man pages. See the scdoc documentation for syntax details.