Allow using the full launch command in session files

Note this is slightly backward incompatible.

docs/changelog.rst

@@ -11,6 +11,11 @@ To update |kitty|, :doc:`follow the instructions <binary>`.
   used by full screen terminal programs and even games, see
   :doc:`keyboard-protocol` (:iss:`3248`)
 
+- **Backward incompatibility**: Session files now use the full :doc:`launch <launch>`
+  command with all its capabilities. However, the syntax of the command is
+  slightly different from before. In particular watchers are now specified
+  directly on launch and env vars are set using ``--env``.
+
 - diff kitten: Implement recursive diff over SSH (:iss:`3268`)
 
 - ssh kitten: Allow using python instead of the shell on the server, useful if

docs/index.rst

@@ -340,7 +340,7 @@ For example:
     launch zsh
     # Create a window with some environment variables set and run
     # vim in it
-    launch env FOO=BAR vim
+    launch --env FOO=BAR vim
     # Set the title for the next window
     title Chat with x
     launch irssi --profile x
@@ -367,14 +367,9 @@ For example:
     focus
     launch emacs
 
-    # Add a watcher that will be called with various events that occur
-    # on all subsequent windows. See the documentation of the launch command
-    # for details on watchers.
-    watcher /some/python/file.py
-    launch mpd
-    launch irssi
-    # Remove the watcher for further windows
-    watcher clear
+.. note::
+    The :doc:`launch <launch>` command when used in a session file
+    cannot create new OS windows, or tabs.
 
 
 Mouse features