Doc: attempt to explain what sessions are

We constantly get feedback that clearly shows that
users do not understand how sessions work.
Updated screenshots.

Change-Id: Ifcf3b08ca2f27e14085a5d84adaeacddc59588d8
Reviewed-by: Daniel Teske <daniel.teske@digia.com>

2 files changed, 12 insertions, 8 deletions

diff --git a/doc/images/qtcreator-welcome-session.png b/doc/images/qtcreator-welcome-session.png
index 04e3419888..a20840611e 100644
--- a/doc/images/qtcreator-welcome-session.png
+++ b/doc/images/qtcreator-welcome-session.png
diff --git a/doc/src/howto/creator-sessions.qdoc b/doc/src/howto/creator-sessions.qdoc
index 4b125e8ca0..61e649cff0 100644
--- a/doc/src/howto/creator-sessions.qdoc
+++ b/doc/src/howto/creator-sessions.qdoc
@@ -34,13 +34,14 @@
     \e session. To restore the session automatically when you start \QC,
     select \gui {File > Session Manager > Restore last session on startup}.
 
-    A session is an arbitrary collection of:
+    When you open or create any of the following items, they automatically
+    become a part of the session:
 
     \list
 
-        \li Open projects with their dependencies (including SUBDIRS projects)
+        \li Projects with their dependencies (including SUBDIRS projects)
 
-        \li Open editors
+        \li Editors
 
         \li Breakpoints and expressions
 
@@ -54,8 +55,11 @@
     developers working on the same projects.
 
     For example, if you work on a project and need to switch to another project
-    for a while, you can save your workspace as a session. This makes it easier
-    to return to working on the first project later.
+    for a while, you can save your workspace as a session and then close the
+    project and all the files in it. Everything that you open after saving the
+    session becomes a part of a new session. When you want to return to working
+    on the first project, open the saved session. \QC opens the projects and
+    files that belong to the session.
 
     To create a new session or remove existing sessions, select \gui File >
     \gui{Session Manager}.
@@ -66,12 +70,12 @@
     not create or select a session, \QC always uses the default session, which
     was created the last time you exited \QC.
 
-    When you launch \QC, a list of existing sessions is displayed on the
-    \gui{Welcome screen}.
+    When you launch \QC, a list of existing sessions is displayed in the
+    \gui Welcome mode.
 
     \image qtcreator-welcome-session.png
 
-    When you start \QC from the command prompt, you can give the name of
+    When you start \QC from the command line, you can give the name of
     a session as argument and \QC will start with this session.
 
     For more information, see \l{Using Command Line Options}.