userguide: clarify quoting of exec commands
This commit is contained in:
parent
dc463077d6
commit
3919dd8daa
@ -785,7 +785,7 @@ keyword. These commands will be run in order.
|
||||
|
||||
See <<command_chaining>> for details on the special meaning of +;+ (semicolon)
|
||||
and +,+ (comma): they chain commands together in i3, so you need to use quoted
|
||||
strings if they appear in your command.
|
||||
strings (as shown in <<exec_quoting>>) if they appear in your command.
|
||||
|
||||
*Syntax*:
|
||||
---------------------------------------
|
||||
@ -1696,7 +1696,7 @@ searched in your +$PATH+.
|
||||
|
||||
See <<command_chaining>> for details on the special meaning of +;+ (semicolon)
|
||||
and +,+ (comma): they chain commands together in i3, so you need to use quoted
|
||||
strings if they appear in your command.
|
||||
strings (as shown in <<exec_quoting>>) if they appear in your command.
|
||||
|
||||
*Syntax*:
|
||||
--------------------------------
|
||||
@ -1720,6 +1720,27 @@ launching. So, if an application is not startup-notification aware (most GTK
|
||||
and Qt using applications seem to be, though), you will end up with a watch
|
||||
cursor for 60 seconds.
|
||||
|
||||
[[exec_quoting]]
|
||||
If the command to be executed contains a +;+ (semicolon) and/or a +,+ (comma),
|
||||
the entire command must be quoted. For example, to have a keybinding for the
|
||||
shell command +notify-send Hello, i3+, you would add an entry to your
|
||||
configuration file like this:
|
||||
|
||||
*Example*:
|
||||
------------------------------
|
||||
# Execute a command with a comma in it
|
||||
bindsym $mod+p exec "notify-send Hello, i3"
|
||||
------------------------------
|
||||
|
||||
If however a command with a comma and/or semicolon itself requires quotes, you
|
||||
must escape the internal quotation marks with double backslashes, like this:
|
||||
|
||||
*Example*:
|
||||
------------------------------
|
||||
# Execute a command with a comma, semicolon and internal quotes
|
||||
bindsym $mod+p exec "notify-send \\"Hello, i3; from $USER\\""
|
||||
------------------------------
|
||||
|
||||
=== Splitting containers
|
||||
|
||||
The split command makes the current window a split container. Split containers
|
||||
|
Loading…
Reference in New Issue
Block a user