From 0bc2d64f1a23f74c6ef1e3bae93c8afea70214ec Mon Sep 17 00:00:00 2001
From: Leena Miettinen <riitta-leena.miettinen@digia.com>
Date: Wed, 17 Apr 2013 12:53:26 +0200
Subject: [PATCH] Doc: add troubleshooting information to tutorial

Add links to information about adding Qt versions and
compilers and configuring kits to the "Building and
Running an Example" tutorial.

Change-Id: I57892ae6ca58ccccfda6512b2b3b9f5bce17b4da
Reviewed-by: Sze Howe Koh <szehowe.koh@gmail.com>
Reviewed-by: Tobias Hunger <tobias.hunger@digia.com>
---
 .../projects/creator-projects-build-run-tutorial.qdoc | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/doc/src/projects/creator-projects-build-run-tutorial.qdoc b/doc/src/projects/creator-projects-build-run-tutorial.qdoc
index a4de638789f..dc32f2cd0f1 100644
--- a/doc/src/projects/creator-projects-build-run-tutorial.qdoc
+++ b/doc/src/projects/creator-projects-build-run-tutorial.qdoc
@@ -48,11 +48,16 @@
             press \key {Alt+Left}.
 
         \li To check that the application code can be compiled and linked for a
-            device, click the \gui {Kit Selector} and select a kit for the
+            device, click the \gui {Kit Selector} and select a
+            \l{glossary-buildandrun-kit}{kit} for the
             device.
 
             \image qtcreator-gs-build-example-kit-selector.png "Selecting a kit to build with"
 
+            If you installed \QC as part of a Qt installation, it should have
+            automatically detected the installed kit. If no kits are available,
+            see \l{Adding Kits}.
+
         \li Click
             \inlineimage qtcreator-run.png
             (\gui Run) to build and run the application.
@@ -60,6 +65,10 @@
         \li To see the compilation progress, press \key{Alt+4} to open the
             \gui {Compile Output} pane.
 
+            If build errors occur, check that a \l{Adding Qt Versions}
+            {Qt version} and \l{Adding Compilers}{compiler} are installed and
+            configured and that the necessary kits are configured.
+
             The \gui Build progress bar on the toolbar turns green when the
             project is successfully built. The application opens on the device.
 
-- 
GitLab