From 22f52b91ed178cf402fe3fc857bbfd351a753b1d Mon Sep 17 00:00:00 2001 From: Drew DeVault Date: Fri, 11 May 2018 21:39:47 -0400 Subject: [PATCH] Add swaylock(1) and swaymsg(1) --- meson.build | 2 + swaylock/swaylock.1.scd | 103 ++++++++++++++++++++++++++++++++++++++++ swaymsg/swaymsg.1.scd | 66 +++++++++++++++++++++++++ 3 files changed, 171 insertions(+) create mode 100644 swaylock/swaylock.1.scd create mode 100644 swaymsg/swaymsg.1.scd diff --git a/meson.build b/meson.build index 1e303e72..a1f406ec 100644 --- a/meson.build +++ b/meson.build @@ -57,6 +57,8 @@ if scdoc.found() 'sway/sway.5.scd', 'sway/sway-bar.5.scd', 'sway/sway-input.5.scd', + 'swaylock/swaylock.1.scd', + 'swaymsg/swaymsg.1.scd', ] foreach filename : man_files topic = filename.split('.')[-3].split('/')[-1] diff --git a/swaylock/swaylock.1.scd b/swaylock/swaylock.1.scd new file mode 100644 index 00000000..2580bff9 --- /dev/null +++ b/swaylock/swaylock.1.scd @@ -0,0 +1,103 @@ +swaylock(1) + +# NAME + +swaylock - Screen locker for Wayland + +# SYNOPSIS + +_swaylock_ [options...] + +Locks your Wayland session. + +# OPTIONS + +*-h, --help* + Show help message and quit. + +*-c, --color* + Turn the screen into the given color. If -i is used, this sets the + background of the image to the given color. Defaults to white (FFFFFF), or + transparent (00000000) if an image is in use. + +*-f, --daemonize* + Fork into the background after spawning. Note: this is the default behavior + of i3lock. + +*-i, --image* [:] + Display the given image, optionally only on the given output. Use -c to set + a background color. + +*--scaling* + Scaling mode for images: _stretch_, _fill_, _fit_, _center_, or _tile_. + +*-t, --tiling* + Same as --scaling=tile. + +*-u, --no-unlock-indicator* + Disable the unlock indicator. + +*-v, --version* + Show the version number and quit. + +# APPEARANCE + +*--bshlcolor* + Sets the color of backspace highlight segments. + +*--font* + Sets the font of the text inside the indicator. + +*--insidecolor* + Sets the color of the inside of the indicator when typing or idle. + +*--insidevercolor* + Sets the color of the inside of the indicator when verifying. + +*--insidewrongcolor* + Sets the color of the inside of the indicator when invalid. + +*--keyhlcolor* + Sets the color of keypress highlight segments. + +*--linecolor* + Sets the color of the lines that separate the inside and outside of the + indicator. + +*-s, --line-uses-inside* + Use the color of the inside of the indicator for the line separating the + inside and outside of the indicator. + +*-r, --line-uses-ring* + Use the outer ring's color for the line separating the inside and outside of + the indicator. + +*--ringcolor* + Sets the color of the outside of the indicator when typing or idle. + +*--ringvercolor* + Sets the color of the outside of the indicator when verifying. + +*--ringwrongcolor* + Sets the color of the outside of the indicator when invalid. + +*--separatorcolor* + Sets the color of the lines that seperate highlight segments. + +*--textcolor* + Sets the color of the text inside the indicator. + +*--indicator-radius* + Sets the radius of the indicator to _radius_ pixels. The default value is + 50. + +*--indicator-thickness* + Sets the thickness of the indicator to _thickness_ pixels. The default value + is 10. + +# AUTHORS + +Maintained by Drew DeVault , who is assisted by other open +source contributors. For more information about sway development, see +https://github.com/swaywm/sway. + diff --git a/swaymsg/swaymsg.1.scd b/swaymsg/swaymsg.1.scd new file mode 100644 index 00000000..1aa6a1b0 --- /dev/null +++ b/swaymsg/swaymsg.1.scd @@ -0,0 +1,66 @@ +swaymsg(1) + +# NAME + +swaymsg - Send messages to a running instance of sway over the IPC socket. + +# SYNOPSIS + +_swaymsg_ [options...] [message] + +# OPTIONS + +*-h, --help* + Show help message and quit. + +*-q, --quiet* + Sends the IPC message but does not print the response from sway. + +*-r, --raw* + Use raw output even if using a tty. + +*-s, --socket* + Use the specified socket path. Otherwise, swaymsg will ask sway where the + socket is (which is the value of $SWAYSOCK, then of $I3SOCK). + +*-t, --type* + Specify the type of IPC message. See below. + +*-v, --version* + Print the version (of swaymsg) and quit. + +# IPC MESSAGE TYPES + +** + The message is a sway command (the same commands you can bind to keybindings + in your sway config file). It will be executed immediately. + + See **sway**(5) for a list of commands. + +*get\_workspaces* + Gets a JSON-encoded list of workspaces and their status. + +*get\_inputs* + Gets a JSON-encoded list of current inputs. + +*get\_outputs* + Gets a JSON-encoded list of current outputs. + +*get\_tree* + Gets a JSON-encoded layout tree of all open windows, containers, outputs, + workspaces, and so on. + +*get\_marks* + Get a JSON-encoded list of marks. + +*get\_bar\_config* + Get a JSON-encoded configuration for swaybar. + +*get\_version* + Get JSON-encoded version information for the running instance of sway. + +*get\_clipboard* + Get JSON-encoded information about the clipboard. + Returns the current clipboard mime-types if called without + arguments, otherwise returns the clipboard data in the requested + formats. Encodes the data using base64 for non-text mime types.