diff options
| author | Isaac Freund <ifreund@ifreund.xyz> | 2021-07-15 22:57:50 +0200 |
|---|---|---|
| committer | Isaac Freund <ifreund@ifreund.xyz> | 2021-07-21 14:01:51 +0200 |
| commit | 1d000e566633bc9fd3de1e3ef4de316623798008 (patch) | |
| tree | d1d6964a55b55ea0c407086281edc68156cdb0cb /doc/rivertile.1.scd | |
| parent | 22251fa7edffc1e888c9bc59d5992e95151ef254 (diff) | |
| download | river-1d000e566633bc9fd3de1e3ef4de316623798008.tar.gz river-1d000e566633bc9fd3de1e3ef4de316623798008.tar.xz | |
rivertile: simplify commands
Instead of having separate commands for modifying/setting a value, use
the presence of a +/- sign to indicate modification.
Diffstat (limited to 'doc/rivertile.1.scd')
| -rw-r--r-- | doc/rivertile.1.scd | 40 |
1 files changed, 20 insertions, 20 deletions
diff --git a/doc/rivertile.1.scd b/doc/rivertile.1.scd index d12a4ce..6143a31 100644 --- a/doc/rivertile.1.scd +++ b/doc/rivertile.1.scd @@ -33,42 +33,42 @@ modified while rivertile is running with the help of *riverctl*(1). layout. (Default: 1) *-main-ratio* _ratio_ - Set the initial ratio of main area to total layout area. The _ratio_ - must be between 0.1 and 0.9, inclusive. (Default: 0.6) + Set the initial ratio of the main area to total layout area. The + _ratio_ must be between 0.1 and 0.9, inclusive. (Default: 0.6) # COMMANDS These commands may be sent to rivertile at runtime with the help of *riverctl*(1). -*set-main-location* [*top*|*bottom*|*left*|*right*] +*main-location* [*top*|*bottom*|*left*|*right*] Set the location of the main area in the layout. -*set-main-count* _count_ - Set the number of views in the main area of the layout. +*main-count* _value_ + Set or modify the number of views in the main area of the layout. If + _value_ is prefixed by a +/- sign, _value_ is added/subtracted from the + current count. If there is no sign, the main count is set to _value_. -*mod-main-count* _delta_ - Modify the number of views in the main area of the layout by a - positive or negative _delta_. +*main-count* _value_ + Set or modify the ratio of the main area to total layout area. If + _value_ is prefixed by a +/- sign, _value_ is added/subtracted from + the current ratio. If there is no sign, the main ratio is set to + _value_. Note that the ratio will always be clamped to the range + 0.1 to 0.9. -*set-main-ratio* _ratio_ - Set the ratio of main area to total layout area. The _ratio_ must - be between 0.1 and 0.9, inclusive. +# EXAMPLES -*mod-main-ratio* _delta_ - Modify the ratio of main area to total layout area by a positive or - negative _delta_. The resulting ratio will be clamped to be between - 0.1 and 0.9, inclusive. +Start *rivertile* with 4 pixels outer padding and the *top* main location: -# EXAMPLES + rivertile -outer-padding 4 -main-location top -Start *rivertile* with 4 pixels outer padding and 2 main views: +Increase the main ratio by 0.1 at runtime: - rivertile -outer-padding 4 -main-count 2 + riverctl send-layout-cmd rivertile "main-ratio +0.1" -Set the main location of rivertile to *top* at runtime: +Set the main count to 3 at runtime: - riverctl send-layout-cmd rivertile "set-main-location top" + riverctl send-layout-cmd rivertile "main-count 3" # AUTHORS |
