diff --git a/kitty/cli.py b/kitty/cli.py
index 44af2bc7d..4a678df13 100644
--- a/kitty/cli.py
+++ b/kitty/cli.py
@@ -896,11 +896,13 @@ def options_spec() -> str:
 --session
 completion=type:file ext:session relative:conf group:"Session files"
 Path to a file containing the startup :italic:`session` (tabs, windows, layout,
-programs). Use - to read from STDIN. See the :file:`README` file for details and
+programs). Use - to read from STDIN. See :ref:`sessions` for details and
 an example. Environment variables in the file name are expanded,
 relative paths are resolved relative to the kitty configuration directory.
 The special value :code:`none` means no session will be used, even if
 the :opt:`startup_session` option has been specified in kitty.conf.
+Note that using this option means the command line arguments to kitty specifying
+a program to run are ignored.
 
 
 --hold
diff --git a/kitty/options/definition.py b/kitty/options/definition.py
index 42a177bdb..5a792bb02 100644
--- a/kitty/options/definition.py
+++ b/kitty/options/definition.py
@@ -3057,7 +3057,8 @@
 instances. See :ref:`sessions` in the kitty documentation for details. Note that
 relative paths are interpreted with respect to the kitty config directory.
 Environment variables in the path are expanded. Changing this option by
-reloading the config is not supported.
+reloading the config is not supported. Note that this prevents kitty from processing
+any command line arguments as a program to run.
 '''
     )