Doc: Added "Qt Examples for iOS" page.

-lists examples that are specifically known to work on iOS
 (based from the list in qtbase/doc/global/manifest-meta.xml)
-focused on Qt Creator and Qt Quick examples.
-excluded Qt Widgets examples from the list
-added links to this new page.

Change-Id: I9d9d775dafd6c6573e2c45ea75756f189e4d07d4
Reviewed-by: Topi Reiniö <topi.reinio@digia.com>

3 files changed, 92 insertions, 1 deletions

diff --git a/doc/src/examples-ios.qdoc b/doc/src/examples-ios.qdoc
new file mode 100644
index 00000000..cbfa0612
--- /dev/null
+++ b/doc/src/examples-ios.qdoc
@@ -0,0 +1,87 @@
+/****************************************************************************
+**
+** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:FDL$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Digia.  For licensing terms and
+** conditions see http://qt.digia.com/licensing.  For further information
+** use the contact form at http://qt.digia.com/contact-us.
+**
+** GNU Free Documentation License Usage
+** 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.  Please review the following information to ensure
+** the GNU Free Documentation License version 1.3 requirements
+** will be met: http://www.gnu.org/copyleft/fdl.html.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+    \page examples-ios.html
+    \title Qt for iOS Examples
+    \brief A list of selected Qt Examples for iOS.
+
+    This page lists Qt Examples known to work for \l{Qt for iOS}{iOS}.
+    This page is not an exclusive list, meaning most
+    \l{Qt Examples and Tutorials}{Qt Examples} are compatible with iOS but
+    are not listed here.
+
+    \section1 Running the Examples
+
+    To run the examples from \l{Qt Creator Manual}{Qt Creator}, open the \gui
+    Welcome mode and select the example from \gui Examples. Entering the search
+    term \gui iOS filters these examples from the other \l{Qt Examples and
+    Tutorials}{Qt Examples}. For more information, visit
+    \l{Qt Creator: Building and Running an Example}{Building and Running an Example}.
+
+    \section1 Essentials
+
+    These pages give instructions on how to get started as well as information
+    related to Qt for iOS.
+
+    \list
+    \li \l{Qt for iOS#Getting Started}{Getting Started with Qt for iOS}
+    \li \l{Qt Creator: Creating a Mobile Application}{Creating a Mobile Application}
+    \li \l{Platform Notes - iOS#Publishing to Apple App Store}{Publishing to Apple App Store}
+    \li \l{Qt Creator: Connecting iOS Devices}{Connecting iOS Devices}
+    \li \l{Porting to iOS}
+    \li \l{Qt for iOS - Building from Source}{Building Qt from Sources}
+    \endlist
+
+    \section1 Qt Quick Examples for iOS
+
+    These are a list of Qt Quick and QML examples for iOS. For a full list
+    of Qt Quick examples including beginner-level tutorials, visit
+    \l{Qt Quick Examples and Tutorials}.
+
+    \div {class="landingicons"}
+    \div {class="icons1of3"}
+        \b{Images, Animation, and Layout}
+        \list
+        \li \l{Qt Quick Examples - Image Elements}{Image Elements}
+        \li \l{Qt Quick Examples - Text}{Text}
+        \li \l{Qt Quick Examples - Animation}{Animation}
+        \li \l{Qt Quick Examples - Canvas}{Canvas}
+        \li \l{Qt Quick Examples - Positioners}{Positioners}
+        \li \l{Qt Quick Examples - Right to Left}{Right to Left}
+        \li \l{Qt Quick Examples - Shader Effects}{Shader Effects}
+        \endlist
+    \enddiv
+    \div {class="icons1of3"}
+        \b{Touch and Key Interaction}
+        \list
+        \li \l{Qt Quick Examples - Touch Interaction}{Touch Interaction}
+        \li \l{Qt Quick Examples - MouseArea}{MouseArea}
+        \endlist
+    \enddiv
+    \enddiv
+*/
diff --git a/doc/src/examples.qdoc b/doc/src/examples.qdoc
index 15d01c23..70a0352e 100644
--- a/doc/src/examples.qdoc
+++ b/doc/src/examples.qdoc
@@ -75,9 +75,10 @@
         \endlist
     \enddiv
     \div {class="icons1of3"}
-        \b{Platform-Specific Extras}
+        \b{Platform Examples}
         \list
         \li \l{Qt for Android Examples}{Android}
+        \li \l{Qt for iOS Examples}{iOS}
         \li \l{Qt Mac Extras Examples}{Mac Extras}
         \li \l{Qt Windows Extras Examples}{Windows Extras}
         \li \l{Active Qt#Examples}{Active Qt Examples}
diff --git a/doc/src/platforms/ios.qdoc b/doc/src/platforms/ios.qdoc
index 6479081b..03f8e0cf 100644
--- a/doc/src/platforms/ios.qdoc
+++ b/doc/src/platforms/ios.qdoc
@@ -115,6 +115,9 @@
     keyword to search for examples in the Qt Creator Welcome mode. Note that
     some examples may have limited functionality.
 
+    For a list of examples known to work on iOS devices, visit
+    \l{Qt for iOS Examples}.
+
     \section1 Using Objective-C Code in Qt Applications
 
     Clang, the compiler used for iOS applications, allows mixing C++