From eacf3d0396ab96ef1ce3e8e9433fa87850143cc6 Mon Sep 17 00:00:00 2001 From: Drew DeVault Date: Sun, 27 Mar 2016 12:41:42 -0400 Subject: Loosen restrictions on commands, update docs Closes #531 --- config | 2 +- sway/commands.c | 6 ------ sway/sway-input.5.txt | 4 ++-- sway/sway.5.txt | 26 +++++++++++++++++++------- 4 files changed, 22 insertions(+), 16 deletions(-) diff --git a/config b/config index d1c323df..0686af2e 100644 --- a/config +++ b/config @@ -18,7 +18,7 @@ set $menu dmenu_run ### Output configuration # -# Default wallpaper - CC-BY-NC from Netzlemming http://netzlemming.deviantart.com/art/Field-of-Barley-05240017-307176737 +# Default wallpaper (more resolutions are available in /usr/share/sway/) output * bg /usr/share/sway/Sway_Wallpaper_Blue_1920x1080.png fill # # Example output configuration: diff --git a/sway/commands.c b/sway/commands.c index e251f167..4d0da26e 100644 --- a/sway/commands.c +++ b/sway/commands.c @@ -215,11 +215,8 @@ static struct cmd_results *cmd_bindsym(int argc, char **argv) { struct cmd_results *error = NULL; if ((error = checkarg(argc, "bindsym", EXPECTED_MORE_THAN, 1))) { return error; - } else if (!config->reading) { - return cmd_results_new(CMD_FAILURE, "bindsym", "Can only be used in config file."); } - struct sway_binding *binding = malloc(sizeof(struct sway_binding)); binding->keys = create_list(); binding->modifiers = 0; @@ -283,11 +280,8 @@ static struct cmd_results *cmd_bindcode(int argc, char **argv) { struct cmd_results *error = NULL; if ((error = checkarg(argc, "bindcode", EXPECTED_MORE_THAN, 1))) { return error; - } else if (!config->reading) { - return cmd_results_new(CMD_FAILURE, "bindcode", "Can only be used in config file."); } - struct sway_binding *binding = malloc(sizeof(struct sway_binding)); binding->keys = create_list(); binding->modifiers = 0; diff --git a/sway/sway-input.5.txt b/sway/sway-input.5.txt index 1ef1dbf8..05dcbeef 100644 --- a/sway/sway-input.5.txt +++ b/sway/sway-input.5.txt @@ -11,8 +11,8 @@ sway-input - input configuration file and commands Description ----------- -Sway allows for configuration of libinput devices. - +Sway allows for configuration of libinput devices through _input { }_ blocks in +your config file. Commands -------- diff --git a/sway/sway.5.txt b/sway/sway.5.txt index d626df48..1bb5cd3b 100644 --- a/sway/sway.5.txt +++ b/sway/sway.5.txt @@ -16,7 +16,8 @@ on startup. These commands usually consist of setting your preferences and setting key bindings. An example config is likely present in /etc/sway/config for you to check out. -Some of the commands can also or only be sent at runtime with **sway-msg**(1). +These commands can be executed in your config file, via **sway-msg**(1), or via +the bindsym command. Commands -------- @@ -26,13 +27,14 @@ The following commands may only be used in the configuration file. **bar** :: Append _{_ to this command, the following lines will be commands that configure **swaybar**, and _}_ on its own line to close the block. + + + See **sway-bar**(5) for details. -**bindsym** :: - Binds _key combo_ to execute _command_ when pressed. You may use XKB key - names here (**xev**(1) is a good tool for discovering them). An example - bindsym command would be _bindsym Mod1+Shift+f exec firefox_, which would - execute Firefox if the alt, shift, and F keys are pressed together. Any - valid sway command is eligible to be bound to a key combo. +**input** :: + Append _{_ to this command, the following lines will be commands to configure + the named input device, and _}_ on its own line will close the block. + + + See **sway-input**(5) for details. **set** :: Creates a substitution for _value_ that can be used with $_name_ in other @@ -107,6 +109,16 @@ They are expected to be used with **bindsym** or at runtime through **swaymsg**( The following commands may be used either in the configuration file or triggered at runtime. +**bindsym** :: + Binds _key combo_ to execute _command_ when pressed. You may use XKB key + names here (**xev**(1) is a good tool for discovering them). An example + bindsym command would be _bindsym Mod1+Shift+f exec firefox_, which would + execute Firefox if the alt, shift, and F keys are pressed together. Any + valid sway command is eligible to be bound to a key combo. + + + **bindcode** is also available for binding with key codes + instead of key names. + **debuglog** :: Enables, disables or toggles logging for debug. The toggle argument cannot be used in the configuration file. -- cgit v1.2.3-54-g00ecf