diff options
| author | user <user@clank> | 2026-08-27 15:17:57 +0200 |
|---|---|---|
| committer | user <user@clank> | 2026-08-27 15:17:57 +0200 |
| commit | ee5790225261fb3d473a16a365bedc15619f93cc (patch) | |
| tree | ca1821d2643d5eeea9af47dcf0ba52ab29ebaf8d /docs/keys.md | |
| parent | test_splash: 'landed' is the row in its final form (diff) | |
| download | slosh-ee5790225261fb3d473a16a365bedc15619f93cc.tar.gz slosh-ee5790225261fb3d473a16a365bedc15619f93cc.tar.xz slosh-ee5790225261fb3d473a16a365bedc15619f93cc.zip | |
a manpage: slosh(1), installed, shipped, and held to the source
The distributables were a bare binary and a directory of Markdown, which
is fine until somebody types 'man slosh' -- the unix-traditional place
to ask. docs/slosh.1 is hand-written man(7), pure ASCII roff, no
toolchain: the synopsis, the options, the session commands, the default
keys, the mouse (including the new drag-past-an-edge scrolling), where
the configuration lives, what SLOSH_* means in a pane's environment,
files, exit status. The prose docs stay the long form; the page says so
and points at them.
'make install' puts it under PREFIX/share/man/man1 (and uninstall takes
it away), the release tarballs carry it beside the LICENSE -- a tarball
is what a packager starts from -- and the Homebrew formula installs it
when the commit it is building has one, guarded because the formula must
be able to build commits older than the page.
Prose about a program drifts unless something holds them together, so
test_docs.py holds the page to the source the way it already holds the
site to docs/nav: every option main.c's parser compares against and
every word command must appear in the page, every SLOSH_* variable the
code reads or sets must be documented, the roff must be pure ASCII (it
travels through implementations that never heard of preconv), and where
groff exists the page must lint clean at CHECKSTYLE=3 with -ww. Adding
a flag without documenting it is now a failing test, which is the only
kind of documentation policy that survives contact with a deadline.
Diffstat (limited to 'docs/keys.md')
0 files changed, 0 insertions, 0 deletions
