nixo
/
gri3-wm
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Merge pull request #2131 from kneitinger/next 

userguide: clarify quoting of exec commands
This commit is contained in:
Michael Stapelberg 2015-12-29 12:18:57 +01:00
parent bc126aaeaf 3919dd8daa
commit 29275598e5
1 changed files with 23 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/userguide
View File

@ -785,7 +785,7 @@ keyword. These commands will be run in order.
See <<command_chaining>> for details on the special meaning of +;+ (semicolon) 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 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*: *Syntax*:
--------------------------------------- ---------------------------------------
@ -1696,7 +1696,7 @@ searched in your +$PATH+.
See <<command_chaining>> for details on the special meaning of +;+ (semicolon) 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 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*: *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 and Qt using applications seem to be, though), you will end up with a watch
cursor for 60 seconds. 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 === Splitting containers
The split command makes the current window a split container. Split containers The split command makes the current window a split container. Split containers