From d08032d6850d28063c0715aa54b1c18e0d0b966d Mon Sep 17 00:00:00 2001 From: Isaac Freund Date: Thu, 15 Apr 2021 00:28:39 +0200 Subject: river-options: rework, bump to v2 Options are now all global but may be overridden per-output. If an output local value is requested but none has been set, the global value is provided instead. This makes for much better ergonomics when configuring layout related options in particular. --- doc/rivertile.1.scd | 31 +++++++++++++++++++++++-------- 1 file changed, 23 insertions(+), 8 deletions(-) (limited to 'doc/rivertile.1.scd') diff --git a/doc/rivertile.1.scd b/doc/rivertile.1.scd index cbf8f32..b099a21 100644 --- a/doc/rivertile.1.scd +++ b/doc/rivertile.1.scd @@ -10,15 +10,31 @@ rivertile - Tiled layout generator for river # DESCRIPTION -*rivertile* is a layout client for river. It provides four tiled layouts per -output with split main/secondary stacks with the main area in different -positions. +*rivertile* is a layout client for river. It provides a simple tiled layout +split main/secondary stacks. -The namespaces of the four layouts are "tile-top", "tile-right", "tile-bottom" -and "tile-left", corresponding to the position of the main area. +# OPTIONS -*rivertile* uses the *main_amount*, *main_factor*, *view_padding* and -*outer_padding* options. +These options may be set using *riverctl*(1) or another river-options +wayland client. *rivertile* declares these options on startup, so setting +these options before starting rivertile requires them to be declared manually. + +*main_location* (string, default "top") + The location of the main area. Vaild locations are "top", "bottom", + "left", and "right". + +*main_count* (uint, default 1) + The number of main views. + +*main_factor* (fixed, default 0.6) + The percentage of the layout area reserved for main views. *rivertle* + clamps this to the range `[0.1, 0.9]`. + +*view_padding* (uint, default 6) + Padding around every view in pixels. + +*outer_padding* (uint, default 6) + Padding around the edge of the layout area in pixels. # AUTHORS @@ -29,4 +45,3 @@ source contributors. For more information about river's development, see # SEE ALSO *river*(1), *riverctl*(1) - -- cgit v1.2.3