Doc: opening projects

Task-number: QTCREATORBUG-2426

Reviewed-by: Tobias Hunger

doc/qtcreator.qdoc

@@ -73,6 +73,7 @@
        \o \l{Managing Projects}
             \list
                 \o \l{Creating a Project}
+                \o \l{Opening a Project}
                 \o \l{Setting Up a qmake Project}
                 \o \l{Adding Libraries to qmake Projects}
                 \o \l{Setting Up a CMake Project}
@@ -1968,6 +1969,7 @@
 
     \list
         \o \l{Creating a Project}
+        \o \l{Opening a Project}
         \o \l{Setting Up a qmake Project}
         \o \l{Adding Libraries to qmake Projects}
         \o \l{Setting Up a CMake Project}
@@ -1985,7 +1987,7 @@
     \contentspage index.html
     \previouspage creator-project-managing.html
     \page creator-project-creating.html
-    \nextpage creator-project-qmake.html
+    \nextpage creator-project-opening.html
 
     \title Creating a Project
 
@@ -2131,6 +2133,69 @@
 */
 
 
+/*!
+    \contentspage index.html
+    \previouspage creator-project-creating.html
+    \page creator-project-opening.html
+    \nextpage creator-project-qmake.html
+
+    \title Opening a Project
+
+    Qt Creator stores information that it needs to build projects in a .user file.
+    If Qt Creator cannot find the file when you open an existing project, it prompts you
+    to enter the information. If you created the project by using another Qt Creator
+    instance, Qt Creator asks whether you want to use the old settings. The settings
+    are specific to the development environment, and should not be copied from one
+    environment to another. Therefore, we recommend that you click \gui No and enter
+    the information again in the \gui {Project Setup} dialog.
+
+    The \gui {Project Setup} dialog displays a list of development environments for
+    target platforms (such as desktop, Maemo devices, and Symbian devices) that are
+    installed on the development PC. Select the Qt versions that you want to use to build
+    the project for each target.
+
+    \image qtcreator-open-project-targets.png "Qt Versions dialog"
+
+    The status \gui New indicates that Qt Creator did not find an existing build
+    for a particular development environment (Qt version) and target. Therefore,
+    Qt Creator starts out from a clean slate, and creates a new build in the directory
+    listed in the \gui {Build Directory} field.
+    By default, Qt Creator does a \l{glossary-shadow-build}{shadow build} and also
+    creates the directory. However, shadow building is not supported for the Symbian
+    target.
+
+    If you have built the project before, Qt Creator can use the existing build
+    configuration to make the exact same build as found in the directory available to
+    Qt Creator. The \gui Status column displays the status \gui Import if Qt creator
+    found an existing build of the project. The status is displayed for each
+    available development environment.
+
+    If you know you have a build, but it is not listed, click \gui {Import Existing
+    Shadow Build} to locate it. Select a directory, and Qt Creator scans it (including
+    subdirectories) for additional builds of the project. Qt Creator adds the found
+    builds to the target list with \gui Import status.
+
+    You can edit the build configuration later. For more information, see
+    \l{Editing Build Configurations}.
+
+    To open a project:
+
+    \list 1
+
+        \o Select \gui File > \gui{Open File or Project} and select the project
+        to open.
+
+        \o In the \gui {Project Setup} dialog, select the Qt versions to use as
+        build targets for your project, and click \gui{Next}.
+
+        \note If you have only one development environment installed, this dialog
+        is skipped.
+
+    \endlist
+
+*/
+
+
 /*!
     \contentspage index.html
     \previouspage creator-project-managing-sessions.html
@@ -2593,7 +2658,7 @@
 
 /*!
     \contentspage index.html
-    \previouspage creator-project-creating.html
+    \previouspage creator-project-opening.html
     \page creator-project-qmake.html
     \nextpage creator-project-qmake-libraries.html