aboutsummaryrefslogtreecommitdiffstats
path: root/doc/src/howto/creator-sessions.qdoc
blob: 67a1e5c317bb18a88f8715eb78e15540b32569c6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
/****************************************************************************
**
** Copyright (c) 2014 Digia Plc and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/legal
**
** This file is part of Qt Creator
**
**
** GNU Free Documentation License
**
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of this
** file.
**
**
****************************************************************************/

// **********************************************************************
// NOTE: the sections are not ordered by their logical order to avoid
// reshuffling the file each time the index order changes (i.e., often).
// Run the fixnavi.pl script to adjust the links to the index order.
// **********************************************************************

/*!
    \contentspage index.html
    \previouspage creator-sharing-project-settings.html
    \page creator-project-managing-sessions.html
    \nextpage creator-design-mode.html

    \title Managing Sessions

    When you exit \QC, a snapshot of your current workspace is stored as a
    \e session. To restore the session automatically when you start \QC,
    select \gui {File > Session Manager > Restore last session on startup}.

    When you open or create any of the following items, they automatically
    become a part of the session:

    \list

        \li Projects with their dependencies (including SUBDIRS projects)

        \li Editors

        \li Breakpoints and expressions

        \li Bookmarks

    \endlist

    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.

    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 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}.

    \image qtcreator-session-manager.png

    To switch between sessions, choose \gui {File > Session Manager}. If you do
    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 in the
    \gui Welcome mode.

    \image qtcreator-welcome-session.png

    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}.

*/