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.