Doc: Bare Metal Devices plugin

This topic needs more information about the
necessary Qt version and the "fake Qt" mentioned.
Also, I cannot try this in practice myself, so
steps might be missing.

Change-Id: I143a54b8559840c3e9ad6dd5d293de160d67867d
Reviewed-by: Christian Kandeler <christian.kandeler@digia.com>
Reviewed-by: hjk <hjk121@nokiamail.com>

doc/src/android/androiddev.qdoc

@@ -21,7 +21,7 @@
     \contentspage index.html
     \previouspage creator-connecting-mobile.html
     \page creator-developing-android.html
-    \nextpage creator-developing-bb10.html
+    \nextpage creator-developing-baremetal.html
 
     \title Connecting Android Devices
 

doc/src/baremetal/creator-baremetal-dev.qdoc

+/****************************************************************************
+**
+** Copyright (c) 2013 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.
+**
+**
+****************************************************************************/
+
+    /*!
+
+    \contentspage index.html
+    \previouspage creator-developing-android.html
+    \page creator-developing-baremetal.html
+    \nextpage creator-developing-bb10.html
+
+    \title Connecting Bare Metal Devices
+
+    You can connect bare metal devices to a development host to run and debug
+    applications on them from \QC using GDB or a hardware debugger. This enables
+    you to debug on small devices that are not supported by the generic remote
+    Linux device plugin. However, if the device does not have Qt libraries, you
+    need a fake Qt installation.
+
+    Currently, you must use qmake to generate Makefiles for building the
+    application.
+
+    The bare metal device type accepts custom GDB commands that you specify in
+    the device options.
+
+    \image creator-baremetal-device.png "Bare Metal Device options"
+
+    To connect bare metal devices:
+
+    \list 1
+
+        \li Select \gui Help > \gui {About Plugins} > \gui {Device Support} >
+            \gui {Bare Metal} to enable the Bare Metal Device plugin.
+
+        \li Restart \QC to be able to use the plugin.
+
+        \li Select \gui Tools > \gui Options > \gui Devices > \gui Add >
+            \gui {Bare Metal Device} > \gui {Start Wizard}.
+
+        \li In the \gui {GDB host} and \gui {GDB port} fields, specify the host
+            name and port number to access the GDB server or hardware debugger.
+
+        \li In the \gui {GDB commands} fields, specify custom commands for the
+            GDB server or hardware debugger.
+
+        \li To specify build settings:
+
+        \list 1
+
+            \li Open a project for an application you want to develop for the
+                device.
+
+            \li Select \gui Projects > \gui {Build & Run} > \gui {Add Kit} to
+                add a kit for building and running applications on bare metal
+                devices.
+
+               \image creator-baremetal-kits.png "Bare Metal Device kits"
+
+        \endlist
+
+        \li Select \gui Run to specify run settings.
+
+            Usually, you can use the default settings.
+
+    \endlist
+
+*/

doc/src/overview/creator-mobile-targets.qdoc

@@ -52,6 +52,11 @@
             2.3.3, or later. You must install the Qt for Android SDK to develop
             for Android devices.
 
+        \li \l{Connecting Bare Metal Devices}
+
+            You can connect bare metal devices to the development PC and use \QC
+            to debug applications on them with GDB or a hardware debugger.
+
         \li \l{Connecting BlackBerry 10 Devices}
 
             \QC enables you to develop, deploy and debug your Qt applications

doc/src/qnx/creator-developing-bb10.qdoc

@@ -20,7 +20,7 @@
 
 /*!
     \contentspage index.html
-    \previouspage creator-developing-android.html
+    \previouspage creator-developing-baremetal.html
     \page creator-developing-bb10.html
     \nextpage creator-developing-generic-linux.html
 

doc/src/qtcreator.qdoc

@@ -26,7 +26,7 @@
 /*!
     \contentspage{index.html}{Qt Creator}
     \page index.html
-    \nextpage creator-getting-started.html
+    \nextpage creator-overview.html
 
     \title Qt Creator Manual
 
@@ -243,6 +243,7 @@
             \li \l{Connecting Mobile Devices}
             \list
                 \li \l{Connecting Android Devices}
+                \li \l{Connecting Bare Metal Devices}
                 \li \l{Connecting BlackBerry 10 Devices}
                 \li \l{Connecting Embedded Linux Devices}
                 \li \l{Connecting iOS Devices}