doc: generate manpages with scdoc

Signed-off-by: NotAShelf <raf@notashelf.dev>
Change-Id: I76a1ac451259af5b4eb86a609b367ca36a6a6964

doc/beer.1.scd

@@ -0,0 +1,92 @@
+beer(1)
+
+# NAME
+
+beer - a fast, software-rendered, Wayland-native terminal emulator
+
+# SYNOPSIS
+
+*beer* [_options_]
+
+# DESCRIPTION
+
+*beer* is a lightweight, CPU-rendered terminal emulator for Wayland. It spawns
+the user's login shell in a pseudo-terminal and renders its output into a
+server-decorated window, with truecolor, styled text, scrollback, incremental
+search, mouse selection, and clipboard integration.
+
+# OPTIONS
+
+*--server*
+	Run as a daemon hosting multiple windows. (Not yet implemented.)
+
+*--config* _PATH_
+	Load configuration from _PATH_ instead of the default location (see
+	*FILES*).
+
+*-h*, *--help*
+	Print usage and exit.
+
+*-V*, *--version*
+	Print the version and exit.
+
+# KEY BINDINGS
+
+These are the built-in defaults; all are configurable in the *key-bindings*
+table of _beer.toml_(5).
+
+[[ *Binding*
+:< *Action*
+|  Ctrl+Shift+C
+:  Copy the selection to the clipboard
+|  Ctrl+Shift+V
+:  Paste from the clipboard
+|  Ctrl+Shift+F
+:  Start incremental scrollback search
+|  Shift+Page_Up / Shift+Page_Down
+:  Scroll the viewport one page
+|  Ctrl+Shift+Home / Ctrl+Shift+End
+:  Scroll to the top / bottom of history
+|  Ctrl+Plus / Ctrl+Equal / Ctrl+Minus
+:  Increase / decrease the font size
+|  Ctrl+0
+:  Reset the font size
+|  F11
+:  Toggle fullscreen
+
+In incremental search, type to refine the query, *Up*/*Return* jumps to the
+previous match, *Down* to the next, and *Escape* exits.
+
+# MOUSE
+
+Left-click and drag selects text; double-click selects a word, triple-click a
+line, and Ctrl+drag selects a rectangular block. The selection is copied to the
+primary selection on release; middle-click pastes it. The wheel scrolls
+history. Holding *Shift* forces local selection even while an application has
+requested mouse reporting.
+
+# ENVIRONMENT
+
+*SHELL*
+	The shell to spawn; defaults to _/bin/sh_.
+
+*TERM*
+	Set to the configured terminal name (default _beer_) for the child.
+
+*BEER_LOG*
+	Log filter, in the _tracing_ env-filter syntax (e.g. _debug_).
+
+# SIGNALS
+
+*SIGUSR1*
+	Reload the configuration file and re-apply it without restarting.
+
+# FILES
+
+_$XDG_CONFIG_HOME/beer/beer.toml_
+	The configuration file (falls back to _~/.config/beer/beer.toml_). See
+	_beer.toml_(5).
+
+# SEE ALSO
+
+_beer.toml_(5)