From 15f36cdc91cbfaca9bf4812b4b91ac269bbf9776 Mon Sep 17 00:00:00 2001 From: Michael Stapelberg Date: Tue, 25 Oct 2011 22:18:40 +0100 Subject: [PATCH] docs/userguide: document the --no-startup-id flag --- docs/userguide | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) 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