Reorganize templates & calendar docs

Change-Id: I0e7a20805fe4823564ee2b312a635d08fa978327
Reviewed-by: J-P Nurmi <jpnurmi@qt.io>

2 files changed, 117 insertions, 0 deletions

diff --git a/src/imports/templates/doc/src/qtquicktemplates2-index.qdoc b/src/imports/templates/doc/src/qtquicktemplates2-index.qdoc
new file mode 100644
index 00000000..2e22196b
--- /dev/null
+++ b/src/imports/templates/doc/src/qtquicktemplates2-index.qdoc
@@ -0,0 +1,54 @@
+/****************************************************************************
+**
+** Copyright (C) 2015 The Qt Company Ltd.
+** Contact: http://www.qt.io/licensing/
+**
+** 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 The Qt Company. For licensing terms
+** and conditions see http://www.qt.io/terms-conditions. For further
+** information use the contact form at http://www.qt.io/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 qtquicktemplates2-index.html
+    \title Qt Quick Templates 2
+    \brief A set of templates to create user interface controls in Qt Quick
+
+    Qt Quick Templates are the foundations of \l {Qt Quick Controls 2}. Templates
+    are non-visual implementations of controls' logic and behavior. They offer
+    an interface to visualize the controls in QML using \l {Qt Quick}.
+
+    Even though the templates aim to be as style-agnostic as possible, in some
+    cases they have to make certain assumptions about the visual structure of
+    a control. For example, a spinbox has buttons that increment and decrement
+    the value of the spinbox. In order to implement the behavior of a spinbox,
+    the spinbox template needs to know if the user is interacting with the up
+    or down button. A visual implementation of the spinbox template merely needs
+    to position the up and down buttons and visualize them in normal, pressed,
+    and disabled states. Any input event handling and state processing is taken
+    care of by the underlying template.
+
+    \section1 Related Information
+
+    \list
+      \li \l{Qt Quick}
+      \li \l{Qt Quick Controls 2}
+      \li \l{Qt Quick Templates 2 QML Types}
+    \endlist
+*/
diff --git a/src/imports/templates/doc/src/qtquicktemplates2-qmltypes.qdoc b/src/imports/templates/doc/src/qtquicktemplates2-qmltypes.qdoc
new file mode 100644
index 00000000..977616bd
--- /dev/null
+++ b/src/imports/templates/doc/src/qtquicktemplates2-qmltypes.qdoc
@@ -0,0 +1,63 @@
+/****************************************************************************
+**
+** Copyright (C) 2015 The Qt Company Ltd.
+** Contact: http://www.qt.io/licensing/
+**
+** 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 The Qt Company. For licensing terms
+** and conditions see http://www.qt.io/terms-conditions. For further
+** information use the contact form at http://www.qt.io/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$
+**
+****************************************************************************/
+
+/*!
+    \qmlmodule QtQuick.Templates 2.0
+    \title Qt Quick Templates 2 QML Types
+    \ingroup qmlmodules
+    \brief Provides QML types for templates (Qt Quick Templates).
+
+    The \l {Qt Quick Templates 2} module provides a set of non-visual templates
+    that can be used to build user interface controls in QML using \l {Qt Quick}.
+
+    The QML types can be imported using the following import statement in your
+    \c .qml file:
+
+    \badcode
+    import QtQuick.Templates 2.1 as T
+    \endcode
+
+    For the sake of clarity, there is a one-to-one mapping between the types
+    provided by the \c QtQuick.Templates and \c QtQuick.Controls imports. For
+    every type available in the \c QtQuick.Controls import, a non-visual template
+    type by the same name exists in the \c QtQuick.Templates import.
+
+    \note It is recommended to use a namespace for the templates import to avoid
+    overlap with the types provided by the \c QtQuick.Controls import.
+
+    \section1 QML Types
+
+    \generatelist {qmltypesbymodule QtQuick.Controls}
+
+    \section1 Related Information
+
+    \list
+        \li \l {Qt Quick Controls 2 QML Types}
+    \endlist
+
+    \noautolist
+*/