From f76227fa509dba3bb65110e0432c31efec4c7c72 Mon Sep 17 00:00:00 2001
From: Leena Miettinen <riitta-leena.miettinen@qt.io>
Date: Mon, 6 Feb 2017 13:13:01 +0100
Subject: [PATCH] Doc: Describe the "New Session Name" dialog

A developer found the options in the dialog confusing.
Also reorganized the "Managing Sessions" topic for
the new text to fit in.

Change-Id: I5bbe0e2bed91ab5759c7d58d0086352ac4ab3751
Reviewed-by: Jesus Fernandez <Jesus.Fernandez@qt.io>
Reviewed-by: Tobias Hunger <tobias.hunger@qt.io>
---
 doc/src/howto/creator-sessions.qdoc | 28 ++++++++++++++++++++--------
 1 file changed, 20 insertions(+), 8 deletions(-)

diff --git a/doc/src/howto/creator-sessions.qdoc b/doc/src/howto/creator-sessions.qdoc
index 744a7f40e2..d24b33c59d 100644
--- a/doc/src/howto/creator-sessions.qdoc
+++ b/doc/src/howto/creator-sessions.qdoc
@@ -56,7 +56,7 @@
 
     \endlist
 
-    A session is  personal, that is, not meant to be shared. It is not supposed
+    A session is personal, that is, not meant to be shared. It is not supposed
     to reflect the project structure. It contains personal data, such as
     bookmarks and breakpoints that are usually not of interest to other
     developers working on the same projects.
@@ -68,16 +68,28 @@
     to working on the first project, switch to the saved session. \QC opens the
     projects and files that belong to the session.
 
-    To save a session under a new name, select \uicontrol File >
-    \uicontrol {Session Manager} > \uicontrol Clone.
-
-    To create a new session, select \uicontrol File >
-    \uicontrol {Session Manager} > \uicontrol New.
+    To manage sessions, select \uicontrol File > \uicontrol {Session Manager}.
 
     \image qtcreator-session-manager.png
 
-    To switch between sessions, choose \uicontrol {File > Session Manager} >
-    \uicontrol {Switch to}.
+    To save a session under a new name, select \uicontrol Clone.
+
+    To create a new session:
+
+    \list 1
+
+        \li Select \uicontrol New.
+
+         \li In the \uicontrol {Enter the name of the session} field, enter a
+             name for the session.
+
+        \li Select \uicontrol Create to create a new empty session or
+            \uicontrol {Create and Open} to create a session and to switch to
+            it.
+
+    \endlist
+
+    To switch between sessions, select \uicontrol {Switch to}.
 
     When you launch \QC, a list of existing sessions is displayed in the
     \uicontrol Welcome mode. To open a session, select it or press
-- 
GitLab