1 files changed, 41 insertions, 0 deletions
diff --git a/doc/river.1 b/doc/river.1
new file mode 100644
index 0000000..3f72980
--- /dev/null
+++ b/doc/river.1
@@ -0,0 +1,41 @@
+.TH RIVER 1 2020-06-04 github.com/ifreund/river "General Commands Manual"
+
+.SH NAME
+river \- dynamic tiling Wayland compositor
+
+.SH SYNOPSIS
+.BR river " [" -c
+.IR shell_command ]
+
+.SH DESCRIPTION
+.B river
+is a dynamic tiling Wayland compositor inspired by dwm and bspwm
+based on wlroots and written in Zig.
+
+.SH OPTIONS
+
+.TP
+.BI -c " shell_command"
+Run a shell command or give the path to a script
+that will be run before river gets started.
+This is where you define keymaps using
+.BR riverctl (1)
+and autostart programs.
+Make sure the script is executable.
+
+.SH CONFIGURATION
+View border width, gap sizes, and programs which should float are configured in
+.IR Config.zig .
+Make your changes and recompile.
+
+.PP
+Experimental XWayland support can be enabled on compile-time with the
+.I -Dxwayland=true
+flag.
+
+Keyboard layout and other XKB options can be set in
+.IR Keyboard.zig .
+
+.SH SEE ALSO
+
+.BR riverctl "(1), " bspwm "(1), " dwm (1)