diff options
author | Campbell Vertesi <campbell@vertesi.com> | 2020-07-13 16:47:20 +0200 |
---|---|---|
committer | Simon Ser <contact@emersion.fr> | 2020-07-15 16:17:11 +0200 |
commit | acbe9028157c67eb3937299ff86e5ee26816a408 (patch) | |
tree | cf0b3dce06d1fdf3721b3bf71031c6de2f56b753 /swaymsg | |
parent | xdg_shell: schedule configure on maximize requests (diff) | |
download | sway-acbe9028157c67eb3937299ff86e5ee26816a408.tar.gz sway-acbe9028157c67eb3937299ff86e5ee26816a408.tar.zst sway-acbe9028157c67eb3937299ff86e5ee26816a408.zip |
Add note on quoting to swaymsg manpage
Diffstat (limited to 'swaymsg')
-rw-r--r-- | swaymsg/swaymsg.1.scd | 18 |
1 files changed, 12 insertions, 6 deletions
diff --git a/swaymsg/swaymsg.1.scd b/swaymsg/swaymsg.1.scd index b8a38b54..4228a0f0 100644 --- a/swaymsg/swaymsg.1.scd +++ b/swaymsg/swaymsg.1.scd | |||
@@ -44,12 +44,18 @@ _swaymsg_ [options...] [message] | |||
44 | The message is a sway command (the same commands you can bind to keybindings | 44 | The message is a sway command (the same commands you can bind to keybindings |
45 | in your sway config file). It will be executed immediately. | 45 | in your sway config file). It will be executed immediately. |
46 | 46 | ||
47 | See **sway**(5) for a list of commands. | 47 | See *sway*(5) for a list of commands. |
48 | 48 | ||
49 | Tip: If you are proving a command that contains a leading hyphen (_-_), | 49 | Tips: |
50 | insert two hyphens (_--_) before the command to signal to swaymsg not to | 50 | - Command expansion is performed twice: once by swaymsg, and again by sway. |
51 | parse anything beyond that point as an option. For example, use | 51 | If you have quoted multi-word strings in your command, enclose the entire |
52 | _swaymsg -- mark --add test_ instead of _swaymsg mark --add test_ | 52 | command in single-quotes. For example, use |
53 | _swaymsg 'output "Foobar Display" enable'_ instead of | ||
54 | _swaymsg output "Foobar Display" enable_. | ||
55 | - If you are proving a command that contains a leading hyphen (_-_), insert | ||
56 | two hyphens (_--_) before the command to signal to swaymsg not to parse | ||
57 | anything beyond that point as an option. For example, use | ||
58 | _swaymsg -- mark --add test_ instead of _swaymsg mark --add test_. | ||
53 | 59 | ||
54 | *get\_workspaces* | 60 | *get\_workspaces* |
55 | Gets a JSON-encoded list of workspaces and their status. | 61 | Gets a JSON-encoded list of workspaces and their status. |