doc: unify scdoc style
This unifies the style of the man page source files. Most noticable are the now consistent line endings at 80 chars (assuming a tabwidth of 8).
This commit is contained in:
Leon Henrik Plickat
committed by
Isaac Freund
Isaac Freund
parent
b2b1a1f5e1
commit
f08d37ab28
@ -1,7 +1,8 @@
|
||||
RIVERCTL(1) "github.com/ifreund/river" "General Commands Manual"
|
||||
|
||||
# NAME
|
||||
|
||||
riverctl - command-line interface for controlling river
|
||||
riverctl - Command-line interface for controlling river
|
||||
|
||||
# SYNOPSIS
|
||||
|
||||
@ -9,8 +10,8 @@ riverctl - command-line interface for controlling river
|
||||
|
||||
# DESCRIPTION
|
||||
|
||||
*riverctl* is a command-line interface inspired by bspc from bspwm
|
||||
used to control and configure river.
|
||||
*riverctl* is a command-line interface inspired by bspc from bspwm used to
|
||||
control and configure river.
|
||||
|
||||
# COMMANDS
|
||||
|
||||
@ -20,15 +21,16 @@ used to control and configure river.
|
||||
Close the focused view.
|
||||
|
||||
*csd-filter-add* _app-id_
|
||||
Add an app-id to the CSD filter list. Windows with this app-id are allowed
|
||||
to use client side decoration instead of the default server side decoration.
|
||||
Add an app-id to the CSD filter list. Windows with this app-id are
|
||||
allowed to use client side decoration instead of the default server
|
||||
side decoration.
|
||||
|
||||
*exit*
|
||||
Exit the compositor, terminating the Wayland session.
|
||||
|
||||
*float-filter-add* _app-id_
|
||||
Add an app-id to the float filter list. Windows with this app-id will start
|
||||
floating.
|
||||
Add an app-id to the float filter list. Windows with this app-id will
|
||||
start floating.
|
||||
|
||||
*focus-output* *next*|*previous*
|
||||
Focus next or previous output.
|
||||
@ -54,15 +56,16 @@ used to control and configure river.
|
||||
the whole screen.
|
||||
|
||||
*move* *up*|*down*|*left*|*right* _delta_
|
||||
Move the focused view in the specified direction by _delta_. The view will
|
||||
be set to floating.
|
||||
Move the focused view in the specified direction by _delta_. The view
|
||||
will be set to floating.
|
||||
|
||||
*resize* *horizontal*|*vertical* _delta_
|
||||
Resize the view in the given orientation by _delta_. The view will be set to
|
||||
floating.
|
||||
Resize the view in the given orientation by _delta_. The view will be
|
||||
set to floating.
|
||||
|
||||
*snap* *up*|*down*|*left*|*right*
|
||||
Snap the view to the specified screen edge. The view will be set to floating.
|
||||
Snap the view to the specified screen edge. The view will be set to
|
||||
floating.
|
||||
|
||||
*send-to-output* *next*|*previous*
|
||||
Send the focused view to the next or the previous output.
|
||||
@ -73,30 +76,29 @@ used to control and configure river.
|
||||
interpreted by your shell before the command gets passed to _/bin/sh_.
|
||||
|
||||
*swap* *next*|*previous*
|
||||
Swap the focused window with the next/previous visible non-floating window.
|
||||
When the focused view is the first view there is no previous view.
|
||||
In this case *previous* swaps with the last view.
|
||||
*next* behaves analogous.
|
||||
Swap the focused window with the next/previous visible non-floating
|
||||
window. When the focused view is the first view there is no previous
|
||||
view. In this case *previous* swaps with the last view. *next* behaves
|
||||
analogous.
|
||||
|
||||
*toggle-float*
|
||||
If the focused view is floating, make it tiled. If it is tiled, make
|
||||
it floating.
|
||||
If the focused view is floating, make it tiled. If it is tiled, make it
|
||||
floating.
|
||||
|
||||
*toggle-fullscreen*
|
||||
Toggle the fullscreen state of the focused view.
|
||||
|
||||
*zoom*
|
||||
Bump the focused view to the top of the layout stack to make it the
|
||||
new master.
|
||||
Bump the focused view to the top of the layout stack to make it the new
|
||||
master.
|
||||
|
||||
## ACTIONS ON TAGS
|
||||
|
||||
Tags are like workspaces but more flexible: You can assign views to
|
||||
multiple tags and look at multiple tags at once. A _tagmask_ is used
|
||||
to represent which tags are visible. The following commands take a
|
||||
_tagmask_ in base 10 as argument but _tagmasks_ are best understood in
|
||||
binary: 000000001 means that the first tag is visible; 111111111 means
|
||||
that tag 1 through 9 are visible.
|
||||
Tags are like workspaces but more flexible: You can assign views to multiple
|
||||
tags and look at multiple tags at once. A _tagmask_ is used to represent which
|
||||
tags are visible. The following commands take a _tagmask_ in base 10 as
|
||||
argument but _tagmasks_ are best understood in binary: 000000001 means that the
|
||||
first tag is visible; 111111111 means that tag 1 through 9 are visible.
|
||||
|
||||
*set-focused-tags* _tagmask_
|
||||
Show the tags specified with _tagmask_.
|
||||
@ -113,7 +115,8 @@ that tag 1 through 9 are visible.
|
||||
## CONFIGURATION COMMANDS
|
||||
|
||||
*attach-mode* *top*|*bottom*
|
||||
Configure where new views should attach in the view stack for the currently focused output.
|
||||
Configure where new views should attach in the view stack for the
|
||||
currently focused output.
|
||||
|
||||
*background-color* _#RRGGBB_|_#RRGGBBAA_
|
||||
Set the background color.
|
||||
@ -134,21 +137,24 @@ that tag 1 through 9 are visible.
|
||||
Switch to given mode if it exits.
|
||||
|
||||
*focus-follows-cursor* *disabled*|*normal*|*strict*
|
||||
When _disabled_ moving the cursor will not influence the focus. This is the default setting.
|
||||
If set to _normal_ moving the cursor over a window will focus that window.
|
||||
The focus still can be changed and moving the cursor within the (now unfocused) window will
|
||||
not change the focus to that window but let the currently focused window in focus.
|
||||
When set to _strict_ this is not the case. The focus will be updated on every cursor movement.
|
||||
When _disabled_ moving the cursor will not influence the focus. This is
|
||||
the default setting. If set to _normal_ moving the cursor over a window
|
||||
will focus that window. The focus still can be changed and moving the
|
||||
cursor within the (now unfocused) window will not change the focus to
|
||||
that window but let the currently focused window in focus. When set to
|
||||
_strict_ this is not the case. The focus will be updated on every
|
||||
cursor movement.
|
||||
|
||||
When the to be focused view is on another output than the currently focused output the view's
|
||||
output is focused.
|
||||
When the to be focused view is on another output than the currently
|
||||
focused output the view's output is focused.
|
||||
|
||||
*map* [-release] _mode_ _modifiers_ _key_ _command_
|
||||
_mode_ is either "normal" (the default mode), "locked" (the mode entered when
|
||||
an input inhibitor such as a lock screen is active) or a mode created with *declare-mode*.
|
||||
If _-release_ is specified the mapping is executed on key release rather than key press.
|
||||
_modifiers_ is a list of one or more of the following
|
||||
modifiers separated with a plus sign:
|
||||
_mode_ is either "normal" (the default mode), "locked" (the mode
|
||||
entered when an input inhibitor such as a lock screen is active) or a
|
||||
mode created with *declare-mode*. If _-release_ is specified the
|
||||
mapping is executed on key release rather than key press. _modifiers_
|
||||
is a list of one or more of the following modifiers separated with a
|
||||
plus sign:
|
||||
|
||||
- Shift
|
||||
- Lock (Caps lock)
|
||||
@ -159,16 +165,18 @@ that tag 1 through 9 are visible.
|
||||
- Mod4 (Super, Logo, Windows)
|
||||
- Mod5
|
||||
|
||||
_key_ is an XKB key name. See _/usr/include/xkbcommon/xkbcommon-keysyms.h_
|
||||
for a list of special key names. _command_ can be any of the above commands.
|
||||
_key_ is an XKB key name. See
|
||||
_/usr/include/xkbcommon/xkbcommon-keysyms.h_ for a list of special key
|
||||
names. _command_ can be any of the above commands.
|
||||
|
||||
A mapping without modifiers can be created by using "None" as sole modifier.
|
||||
A mapping without modifiers can be created by using "None" as sole
|
||||
modifier.
|
||||
|
||||
*map-pointer* _mode_ _modifiers_ _button_ _action_
|
||||
_mode_ and _modifiers_ are the same as for *map*.
|
||||
|
||||
_button_ is the name of a linux input event code. The most commonly used
|
||||
values are:
|
||||
_button_ is the name of a linux input event code. The most commonly
|
||||
used values are:
|
||||
|
||||
- BTN_LEFT - left mouse button
|
||||
- BTN_RIGHT - right mouse button
|
||||
@ -184,17 +192,18 @@ that tag 1 through 9 are visible.
|
||||
*opacity* _focused-opacity_ _unfocused-opacity_ _starting-opacity_ _opacity-step_ _opacity-delta-t_
|
||||
Set the server side opacity of views.
|
||||
|
||||
_focused-opacity_ sets the opacity of the focused window, _unfocused-opacity_
|
||||
the opacity of every unfocused window while _starting-opacity_ sets the
|
||||
opacity a window will have at startup before immediately transitioning to
|
||||
either the focused or unfocused opacity. These settings require a floating
|
||||
point number from 0.0 (fully transparent) to 1.0 (fully opaque).
|
||||
_focused-opacity_ sets the opacity of the focused window,
|
||||
_unfocused-opacity_ the opacity of every unfocused window while
|
||||
_starting-opacity_ sets the opacity a window will have at startup
|
||||
before immediately transitioning to either the focused or unfocused
|
||||
opacity. These settings require a floating point number from 0.0 (fully
|
||||
transparent) to 1.0 (fully opaque).
|
||||
|
||||
Opacity transitions can be animated. _opacity-step_ sets the amount the
|
||||
opacity should be increased or decreased per step of the transition. It
|
||||
requires a floating point number from 0.05 to 1.0. If set to 1.0, animations
|
||||
are disabled. _opacity-delta-t_ sets the time between the transition steps
|
||||
in milliseconds.
|
||||
requires a floating point number from 0.05 to 1.0. If set to 1.0,
|
||||
animations are disabled. _opacity-delta-t_ sets the time between the
|
||||
transition steps in milliseconds.
|
||||
|
||||
*outer-padding* _pixels_
|
||||
Set the padding around the edge of the screen to _pixels_.
|
||||
@ -204,21 +213,21 @@ that tag 1 through 9 are visible.
|
||||
repeat delay to _delay_ milliseconds.
|
||||
|
||||
*unmap* [-release] _mode_ _modifiers_ _key_
|
||||
Removes the mapping defined by the arguments *-release*, *modifiers* and *key* from *mode*.
|
||||
See *map* for an explanation of the arguments.
|
||||
Removes the mapping defined by the arguments *-release*, *modifiers*
|
||||
and *key* from *mode*. See *map* for an explanation of the arguments.
|
||||
|
||||
*unmap-pointer* _mode_ _modifiers_ _button_
|
||||
Removes the mapping defined by the arguments *modifiers* and *button* from *mode*.
|
||||
See *map-pointer* for an explanation of the arguments.
|
||||
Removes the mapping defined by the arguments *modifiers* and *button*
|
||||
from *mode*. See *map-pointer* for an explanation of the arguments.
|
||||
|
||||
*view-padding* _pixels_
|
||||
Set the padding around the edge of each view to _pixels_.
|
||||
|
||||
*xcursor-theme* _theme_name_ [_size_]
|
||||
Set the xcursor theme to _theme_name_ and optionally set the
|
||||
_size_. The theme of the default seat determines the default
|
||||
for XWayland and made available through the _XCURSOR_THEME_ and
|
||||
_XCURSOR_SIZE_ environment variables.
|
||||
Set the xcursor theme to _theme_name_ and optionally set the _size_.
|
||||
The theme of the default seat determines the default for XWayland and
|
||||
made available through the _XCURSOR_THEME_ and _XCURSOR_SIZE_
|
||||
environment variables.
|
||||
|
||||
# EXAMPLES
|
||||
|
||||
|
||||
Reference in New Issue
Block a user