From: Michael Stapelberg <michael@stapelberg.de>
Date: Tue, 25 Oct 2011 21:18:40 +0000 (+0100)
Subject: docs/userguide: document the --no-startup-id flag
X-Git-Tag: 4.1~46^2~3
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=15f36cdc91cbfaca9bf4812b4b91ac269bbf9776;p=i3%2Fi3

docs/userguide: document the --no-startup-id flag
---

diff --git a/docs/userguide b/docs/userguide
index 6db4d5e7..c40b6676 100644
--- a/docs/userguide
+++ b/docs/userguide
@@ -1034,6 +1034,35 @@ The criteria +class+, +instance+, +role+, +title+ and +mark+ are actually
 regular expressions (PCRE). See +pcresyntax(3)+ or +perldoc perlre+ for
 information on how to use them.
 
+=== Executing applications (exec)
+
+What good is a window manager if you can’t actually start any applications?
+The exec command starts an application by passing the command you specify to a
+shell. This implies that you can use globbing (wildcards) and programs will be
+searched in your $PATH.
+
+*Syntax*:
+------------------------------
+exec [--no-startup-id] command
+------------------------------
+
+*Example*:
+------------------------------
+# Start the GIMP
+bindsym mod+g exec gimp
+
+# Start the terminal emulator urxvt which is not yet startup-notification-aware
+bindsym mod+enter exec --no-startup-id urxvt
+------------------------------
+
+The +--no-startup-id+ parameter disables startup-notification support for this
+particular exec command. With startup-notification, i3 can make sure that a
+window appears on the workspace on which you used the exec command. Also, it
+will change the X11 cursor to +watch+ (a clock) while the application is
+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.
+
 === Splitting containers
 
 The split command makes the current window a split container. Split containers