Create doc pages for QML focus and minehunt examples.

Link to declarative examples from Qt's examples page.

8 files changed, 132 insertions, 23 deletions

diff --git a/doc/src/declarative/declarativeui.qdoc b/doc/src/declarative/declarativeui.qdoc
index a2a5283..55945e6 100644
--- a/doc/src/declarative/declarativeui.qdoc
+++ b/doc/src/declarative/declarativeui.qdoc
@@ -75,7 +75,7 @@ completely new applications.  QML is fully \l {Extending QML in C++}{extensible
 \o \l {Introduction to the QML language}
 \o \l {QML Tutorial}{Tutorial: 'Hello World'}
 \o \l {QML Advanced Tutorial}{Tutorial: 'Same Game'}
-\o \l {QML Examples and Walkthroughs}
+\o \l {QML Examples and Demos}
 \o \l {Using QML in C++ Applications}
 \o \l {QML for Qt programmers}
 \endlist
diff --git a/doc/src/declarative/examples.qdoc b/doc/src/declarative/examples.qdoc
index 3d8325e..8e28e59 100644
--- a/doc/src/declarative/examples.qdoc
+++ b/doc/src/declarative/examples.qdoc
@@ -41,18 +41,22 @@
 
 /*!
 \page qdeclarativeexamples.html
-\title QML Examples and Walkthroughs
+\title QML Examples and Demos
 
-\section1 Running Examples and Demos
+\previouspage Graphics View Examples
+\contentspage Qt Examples
+\nextpage Painting Examples
+
+\section1 Running the examples
 
 You can find many simple examples in the \c examples/declarative
 sub-directory that show how to use various aspects of QML. In addition, the
 \c demos/declarative sub-directory contains more sophisticated demos of large
 applications. These demos are intended to show integrated functionality
-rather than being instructive on specifice elements.
+rather than being instructive on specific elements.
 
-To run the examples and demos, use the included \l {Qt Declarative UI Runtime}{qml}
-application. It has some useful options, revealed by:
+To run the examples and demos, you can use Qt Creator or the included \l {Qt Declarative UI Runtime}{qml}
+command-line application. It has some useful options, revealed by:
 
 \code
     bin/qml -help
@@ -66,18 +70,14 @@ For example, from your build directory, run:
 
 \section1 Examples
 
-These will be documented, and demonstrate how to achieve various things in QML.
+\list
+\o \l{declarative/focus}{Focus}
+\endlist
+
+\section1 Demos
 
-\table
-\row
-    \o Elastic Dial
-    \o \image dial-example.gif
-\row
-    \o \l{qdeclarativeexampletoggleswitch.html}{Toggle Switch}
-    \o \image switch-example.gif
-\row
-    \o \l{QML Advanced Tutorial}{SameGame}
-    \o \image declarative-adv-tutorial4.gif
-\endtable
+\list
+\o \l{demos/declarative/minehunt}{Minehunt}
+\endlist
 
 */
diff --git a/doc/src/declarative/qdeclarativereference.qdoc b/doc/src/declarative/qdeclarativereference.qdoc
index b2cfba8..4c1f449 100644
--- a/doc/src/declarative/qdeclarativereference.qdoc
+++ b/doc/src/declarative/qdeclarativereference.qdoc
@@ -55,7 +55,7 @@
     That is, you specify \e what the UI should look like and how it should behave
     rather than specifying step-by-step \e how to build it. Specifying a UI declaratively
     does not just include the layout of the interface items, but also the way each
-    individual item looks and behaves and the overall flow of the application.    
+    individual item looks and behaves and the overall flow of the application.
 
     The QML elements provide a sophisticated set of graphical and behavioral building
     blocks.  These different elements are combined together in \l {QML Documents}{QML documents} to build components
@@ -67,7 +67,7 @@
     \o \l {Introduction to the QML language}
     \o \l {QML Tutorial}{Tutorial: 'Hello World'}
     \o \l {QML Advanced Tutorial}{Advanced Tutorial: 'Same Game'}
-    \o \l {QML Examples and Walkthroughs}
+    \o \l {QML Examples and Demos}
     \endlist
 
     \section1 Core QML Features:
diff --git a/doc/src/examples/qml-focus.qdoc b/doc/src/examples/qml-focus.qdoc
new file mode 100644
index 0000000..92d93b2
--- /dev/null
+++ b/doc/src/examples/qml-focus.qdoc
@@ -0,0 +1,49 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+    \title Focus
+    \example declarative/focus
+
+    This example shows how to handle keys and focus in QML.
+
+    \image qml-focus-example.png
+*/
diff --git a/doc/src/examples/qml-minehunt.qdoc b/doc/src/examples/qml-minehunt.qdoc
new file mode 100644
index 0000000..773f216
--- /dev/null
+++ b/doc/src/examples/qml-minehunt.qdoc
@@ -0,0 +1,49 @@
+/****************************************************************************
+**
+** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+    \title Minehunt
+    \example demos/declarative/minehunt
+
+    This demo shows how to create a simple Minehunt game with QML and C++.
+
+    \image qml-minehunt-example.png
+*/
diff --git a/doc/src/getting-started/examples.qdoc b/doc/src/getting-started/examples.qdoc
index 885e96c..9ddafc4 100644
--- a/doc/src/getting-started/examples.qdoc
+++ b/doc/src/getting-started/examples.qdoc
@@ -151,6 +151,17 @@
     classes.
 
     \clearfloat
+    \section1 \l{QML Examples and Demos}{Declarative}
+    \beginfloatleft
+    \l{QML Examples and Demos}{\inlineimage declarative-examples.png
+    }
+
+    \endfloat
+    The Qt Declarative module provides a declarative framework for building
+    highly dynamic, custom user interfaces.
+    classes.
+
+    \clearfloat
     \section1 \l{Painting Examples}{Painting}
     \beginfloatleft
     \l{Painting Examples}{\inlineimage painting-examples.png
@@ -626,7 +637,7 @@
 
     \previouspage Item Views Examples
     \contentspage Qt Examples
-    \nextpage Painting Examples
+    \nextpage QML Examples and Demos
 
     \image graphicsview-examples.png
 
@@ -669,7 +680,7 @@
     \page examples-painting.html
     \title Painting Examples
 
-    \previouspage Graphics View Examples
+    \previouspage QML Examples and Demos
     \contentspage Qt Examples
     \nextpage Rich Text Examples
 
@@ -1323,7 +1334,7 @@
     \o \l{dbus/complexpingpong}{Complex Ping Pong}
     \o \l{dbus/listnames}{List Names}
     \o \l{dbus/pingpong}{Ping Pong}
-    \o \l{dbus/remotecontrolledcar}{Remote Controlled Car} 
+    \o \l{dbus/remotecontrolledcar}{Remote Controlled Car}
     \endlist
 
     Examples marked with an asterisk (*) are fully documented.
diff --git a/doc/src/images/qml-focus-example.png b/doc/src/images/qml-focus-example.png
new file mode 100644
index 0000000..5a114a0
--- /dev/null
+++ b/doc/src/images/qml-focus-example.png
diff --git a/doc/src/images/qml-minehunt-example.png b/doc/src/images/qml-minehunt-example.png
new file mode 100644
index 0000000..3b69569
--- /dev/null
+++ b/doc/src/images/qml-minehunt-example.png