Doc: fix issues to display examples in Qt Creatorv5.4.1

- Add \brief commands to example docs to show descriptions
- Add an examples page with the \group command
- Link to the examples page from the module index page
- Edit the .qdocconf file
- Edit the .gitignore file to allow pushing changes to examples
- Add a generic thumbnail image for C++ Code Analyzer example

Change-Id: I1a313ae26664ce9fc50ef8962f0facd57dea546b
Reviewed-by: Martin Smith <martin.smith@digia.com>
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>

10 files changed, 114 insertions, 87 deletions

diff --git a/.gitignore b/.gitignore
index 446d0d9..10b0f68 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,14 +1,6 @@
 # This file is used to ignore files which are generated in the Qt build system
 # ----------------------------------------------------------------------------
 
-examples/*/*/*
-!examples/*/*/*[.]*
-!examples/*/*/README
-examples/*/*/*[.]app
-!examples/declarative/*
-!examples/tutorials/*
-!examples/tutorials/*/*
-!examples/ja_JP/*/*
 demos/*/*
 !demos/spectrum/*
 demos/spectrum/bin
diff --git a/examples/xmlpatterns/filetree/doc/src/filetree.qdoc b/examples/xmlpatterns/filetree/doc/src/filetree.qdoc
index 1093d56..218bf47 100644
--- a/examples/xmlpatterns/filetree/doc/src/filetree.qdoc
+++ b/examples/xmlpatterns/filetree/doc/src/filetree.qdoc
@@ -1,6 +1,6 @@
 /****************************************************************************
 **
-** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** 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.
@@ -26,9 +26,11 @@
 ****************************************************************************/
 
 /*!
-  \example xmlpatterns/filetree
+  \example filetree
   \title File System Example
   \ingroup xmlpattern_examples
+  \brief Using Qt XML Patterns for querying non-XML data that is modeled to
+  look like XML.
 
   This example shows how to use Qt XML Patterns for querying non-XML
   data that is modeled to look like XML.
@@ -69,7 +71,7 @@
   \c{main.cpp} (\c{Q_INIT_RESOURCE(queries);}). It lists the XQuery
   files (\c{.xq}) that can be selected in the combobox.
 
-  \quotefromfile xmlpatterns/filetree/queries.qrc
+  \quotefromfile filetree/queries.qrc
   \printuntil
 
   To add your own queries to the example's combobox, store your
@@ -104,12 +106,12 @@
   QSimpleXmlNodeModel. When you implement your own custom node model,
   you must provide implementations for these callback functions:
 
-  \snippet xmlpatterns/filetree/filetree.h 0
-  \snippet xmlpatterns/filetree/filetree.h 1
+  \snippet filetree/filetree.h 0
+  \snippet filetree/filetree.h 1
 
   The \c{FileTree} class declares four data members:
 
-  \snippet xmlpatterns/filetree/filetree.h 2
+  \snippet filetree/filetree.h 2
 
   The QVector \c{m_fileInfos} will contain the node model. Each
   QFileInfo in the vector will represent a file or a directory in the
@@ -141,7 +143,7 @@
   types:
 
   \target Node_Type
-  \snippet xmlpatterns/filetree/filetree.h 4
+  \snippet filetree/filetree.h 4
 
   \c{Directory} and \c{File} will represent the XML element nodes for
   directories and files respectively, and the other enum values will
@@ -150,7 +152,7 @@
   initializes \c{m_names} with an appropriate QXmlName for each
   element and attribute type:
 
-  \snippet xmlpatterns/filetree/filetree.cpp 2
+  \snippet filetree/filetree.cpp 2
 
   Note that the constructor does \e{not} pre-build the entire node
   model. Instead, the node model is built \e{incrementally} as the
@@ -176,7 +178,7 @@
   a QFileInfo, the class uses the private function \c{toNodeIndex()}:
 
   \target main toNodeIndex
-  \snippet xmlpatterns/filetree/filetree.cpp 1
+  \snippet filetree/filetree.cpp 1
 
   It searches the \c{m_fileInfos} vector for a QFileInfo that matches
   \c{fileInfo}. If a match is found, its array index is passed to
@@ -211,12 +213,12 @@
   type directly from the QFileInfo:
 
   \target toNodeIndex of convenience
-  \snippet xmlpatterns/filetree/filetree.cpp 0
+  \snippet filetree/filetree.cpp 0
 
   Note that the auxiliary vector \c{m_names} is accessed using the
   \l{Node_Type} {node type}, for example:
 
-  \snippet xmlpatterns/filetree/filetree.cpp 3
+  \snippet filetree/filetree.cpp 3
 
   Most of the virtual functions in the callback interface are as
   simple as the ones described so far, but the callback function used
@@ -253,7 +255,7 @@
   each \l{QAbstractXmlNodeModel::SimpleAxis} {axis}.
 
   \target next node on axis
-  \snippet xmlpatterns/filetree/filetree.cpp 4
+  \snippet filetree/filetree.cpp 4
 
   The first thing this function does is call \l{to file info}
   {toFileInfo()} to get the QFileInfo of the context node. The use of
@@ -262,7 +264,7 @@
   in \c{m_fileInfos}.
 
   \target to file info
-  \snippet xmlpatterns/filetree/filetree.cpp 6
+  \snippet filetree/filetree.cpp 6
 
   The \l{QAbstractXmlNodeModel::Parent} {Parent} case looks up the
   context node's parent by constructing a QFileInfo from the context
@@ -294,7 +296,7 @@
   sibling to the node model, if it isn't in the model yet.
 
   \target nextSibling helper
-  \snippet xmlpatterns/filetree/filetree.cpp 5
+  \snippet filetree/filetree.cpp 5
 
   \section2 The UI Class: MainWindow
 
@@ -302,7 +304,7 @@
   QMainWindow and the Ui_MainWindow base class generated by
   \l{Qt Designer Manual} {Qt Designer}.
 
-  \snippet xmlpatterns/filetree/mainwindow.h 0
+  \snippet filetree/mainwindow.h 0
 
   It contains the custom node model (\c{m_fileTree}) and an instance
   of QXmlNodeModelIndex (\c{m_fileNode}) used for holding the node
@@ -318,13 +320,13 @@
   be loaded into the custom node model. Choosing a directory signals
   the \c{on_actionOpenDirectory_triggered()} slot:
 
-  \snippet xmlpatterns/filetree/mainwindow.cpp 1
+  \snippet filetree/mainwindow.cpp 1
 
   The slot function simply calls the private function
   \c{loadDirectory()} with the path of the chosen directory:
 
   \target the standard code pattern
-  \snippet xmlpatterns/filetree/mainwindow.cpp 4
+  \snippet filetree/mainwindow.cpp 4
 
   \c{loadDirectory()} demonstrates a standard code pattern for using
   Qt XML Patterns programatically. First it gets the node model index
@@ -361,12 +363,12 @@
   right. Choosing an XQuery signals the
   \c{on_queryBox_currentIndexChanged()} slot:
 
-  \snippet xmlpatterns/filetree/mainwindow.cpp 2
+  \snippet filetree/mainwindow.cpp 2
 
   The slot function opens and loads the query file and then calls the
   private function \c{evaluateResult()} to run the query:
 
-  \snippet xmlpatterns/filetree/mainwindow.cpp 3
+  \snippet filetree/mainwindow.cpp 3
 
   \c{evaluateResult()} is a second example of the same code pattern
   shown in \l{the standard code pattern} {loadDirectory()}. In this
@@ -388,8 +390,8 @@
   \c{FileTree} class, we can strip the running of \c{wholeTree.xq} out
   of \l{the standard code pattern} {MainWindow::loadDirectory()}:
 
-  \snippet xmlpatterns/filetree/mainwindow.cpp 5
-  \snippet xmlpatterns/filetree/mainwindow.cpp 6
+  \snippet filetree/mainwindow.cpp 5
+  \snippet filetree/mainwindow.cpp 6
 
   Note, however, that \c{FileTree} doesn't have the capability of
   deleting all or part of the node model. The node model, once built,
diff --git a/examples/xmlpatterns/recipes/doc/src/recipes.qdoc b/examples/xmlpatterns/recipes/doc/src/recipes.qdoc
index 3e8b396..e989359 100644
--- a/examples/xmlpatterns/recipes/doc/src/recipes.qdoc
+++ b/examples/xmlpatterns/recipes/doc/src/recipes.qdoc
@@ -1,6 +1,6 @@
 /****************************************************************************
 **
-** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** 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.
@@ -26,9 +26,10 @@
 ****************************************************************************/
 
 /*!
-  \example xmlpatterns/recipes
+  \example recipes
   \title Recipes Example
   \ingroup xmlpattern_examples
+  \brief Using Qt XML Patterns to query XML data loaded from a file.
 
   The Recipes example shows how to use Qt XML Patterns to query XML data
   loaded from a file.
@@ -67,7 +68,7 @@
   \c{main.cpp} (\c{Q_INIT_RESOURCE(recipes);}). It lists the XQuery
   files (\c{.xq}) that can be selected in the combobox.
 
-  \quotefromfile xmlpatterns/recipes/recipes.qrc
+  \quotefromfile recipes/recipes.qrc
   \printuntil
 
   To add your own queries to the example's combobox, store your
@@ -80,7 +81,7 @@
   QApplication. Then it creates an instance of the UI class, shows it,
   and starts the Qt event loop:
 
-  \snippet xmlpatterns/recipes/main.cpp 0
+  \snippet recipes/main.cpp 0
 
   \section2 The UI Class: QueryMainWindow
 
@@ -88,7 +89,7 @@
   QMainWindow and the class generated by \l{Qt Designer Manual} {Qt
   Designer}:
 
-  \snippet xmlpatterns/recipes/querymainwindow.h 0
+  \snippet recipes/querymainwindow.h 0
 
   The constructor finds the window's \l{QComboBox} {combo box} child
   widget and connects its \l{QComboBox::currentIndexChanged()}
@@ -98,7 +99,7 @@
   viewer} . Finally, it finds the XQuery files (\c{.xq}) and adds each
   one to the \l{QComboBox} {combo box} menu.
 
-  \snippet xmlpatterns/recipes/querymainwindow.cpp 0
+  \snippet recipes/querymainwindow.cpp 0
 
   The work is done in the \l{displayQuery() slot} {displayQuery()}
   slot and the \l{evaluate() function} {evaluate()} function it
@@ -107,7 +108,7 @@
   function} {evaluate()}.
 
   \target displayQuery() slot
-  \snippet xmlpatterns/recipes/querymainwindow.cpp 1
+  \snippet recipes/querymainwindow.cpp 1
 
   \l{evaluate() function} {evaluate()} demonstrates the standard
   Qt XML Patterns usage pattern. First, an instance of QXmlQuery is
@@ -125,7 +126,7 @@
   called to ensure that the XQuery was correctly parsed.
 
   \target evaluate() function
-  \snippet xmlpatterns/recipes/querymainwindow.cpp 2
+  \snippet recipes/querymainwindow.cpp 2
 
   If the XQuery is valid, an instance of QXmlFormatter is created to
   format the query result as XML into a QBuffer. To evaluate the
@@ -137,7 +138,7 @@
   \note Each XQuery \c{.xq} file must declare the \c{$inputDocument}
   variable to represent the \c cookbook.xml document:
 
-  \code
+  \badcode
   (: All ingredients for Mushroom Soup. :)
   declare variable $inputDocument external;
 
diff --git a/examples/xmlpatterns/schema/doc/src/schema.qdoc b/examples/xmlpatterns/schema/doc/src/schema.qdoc
index b628bca..63c8418 100644
--- a/examples/xmlpatterns/schema/doc/src/schema.qdoc
+++ b/examples/xmlpatterns/schema/doc/src/schema.qdoc
@@ -1,6 +1,6 @@
 /****************************************************************************
 **
-** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** 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.
@@ -26,9 +26,10 @@
 ****************************************************************************/
 
 /*!
-  \example xmlpatterns/schema
+  \example schema
   \title XML Schema Validation Example
   \ingroup xmlpattern_examples
+  \brief Using Qt XML Patterns to validate XML with a W3C XML Schema.
 
   The XML Schema Validation example shows how to use Qt XML Patterns to
   validate XML with a W3C XML Schema.
@@ -69,7 +70,7 @@
   QApplication. Then it creates an instance of the mainwindow class, shows it,
   and starts the Qt event loop:
 
-  \snippet xmlpatterns/schema/main.cpp 0
+  \snippet schema/main.cpp 0
 
   \section2 The UI Class: MainWindow
 
@@ -77,7 +78,7 @@
   QMainWindow and the class generated by \l{Qt Designer Manual} {Qt
   Designer}:
 
-  \snippet xmlpatterns/schema/mainwindow.h 0
+  \snippet schema/mainwindow.h 0
 
   The constructor fills the schema and instance \l{QComboBox} selections with the predefined
   schemas and instances and connects their \l{QComboBox::currentIndexChanged()} {currentIndexChanged()}
@@ -88,20 +89,20 @@
   The call to \c{schemaSelected(0)} and \c{instanceSelected(0)} will trigger the validation
   of the initial Contact Schema example.
 
-  \snippet xmlpatterns/schema/mainwindow.cpp 0
+  \snippet schema/mainwindow.cpp 0
 
   In the \c{schemaSelected()} slot the content of the instance \l{QComboBox} {selection}
   is adapted to the selected schema and the corresponding schema is loaded from the
   \l{The Qt Resource System} {resource file} and displayed in the schema \l{QTextBrowser} {viewer}.
   At the end of the method a revalidation is triggered.
 
-  \snippet xmlpatterns/schema/mainwindow.cpp 1
+  \snippet schema/mainwindow.cpp 1
 
   In the \c{instanceSelected()} slot the selected instance is loaded from the
   \l{The Qt Resource System} {resource file} and loaded into the instance \l{QTextEdit} {editor}
   an the revalidation is triggered again.
 
-  \snippet xmlpatterns/schema/mainwindow.cpp 2
+  \snippet schema/mainwindow.cpp 2
 
   The \c{validate()} slot does the actual work in this example.
   At first it stores the content of the schema \l{QTextBrowser} {viewer} and the
@@ -110,7 +111,7 @@
   \l{QAbstractMessageHandler} {QAbstractMessageHandler} and is a convenience
   class to store error messages from the XmlPatterns system.
 
-  \snippet xmlpatterns/schema/mainwindow.cpp 4
+  \snippet schema/mainwindow.cpp 4
 
   After the \l{QXmlSchema} {QXmlSchema} is instanciated and the message handler set
   on it, the \l{QXmlSchema::load()} {load()} method is called with the schema data as argument.
@@ -126,5 +127,5 @@
 
   The rest of the code does only some fancy coloring and eyecandy.
 
-  \snippet xmlpatterns/schema/mainwindow.cpp 3
+  \snippet schema/mainwindow.cpp 3
 */
diff --git a/examples/xmlpatterns/xquery/doc/src/globalVariables.qdoc b/examples/xmlpatterns/xquery/doc/src/globalVariables.qdoc
index bc5011c..a11a972 100644
--- a/examples/xmlpatterns/xquery/doc/src/globalVariables.qdoc
+++ b/examples/xmlpatterns/xquery/doc/src/globalVariables.qdoc
@@ -1,6 +1,6 @@
 /****************************************************************************
 **
-** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** 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.
@@ -26,10 +26,13 @@
 ****************************************************************************/
 
 /*!
-    \example xmlpatterns/xquery
+    \example xquery
     \title C++ Source Code Analyzer Example
     \ingroup xmlpattern_examples
 
+    \brief Using XQuery and the \c xmlpatterns command line utility to
+    query C++ source code.
+
     This example uses XQuery and the \c xmlpatterns command line utility to
     query C++ source code.
 
@@ -68,7 +71,7 @@
 
     Consider the declarations in this hypothetical C++ application:
 
-    \snippet xmlpatterns/xquery/globalVariables/globals.cpp 0
+    \snippet xquery/globalVariables/globals.cpp 0
 
     \section3 The XML description of the C++ application
 
@@ -76,7 +79,7 @@
     \l{http://public.kitware.com/GCC_XML/HTML/Index.html} {GCC-XML}
     produces this XML description:
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/globals.gccxml
+    \quotefromfile xquery/globalVariables/globals.gccxml
     \printuntil
 
     \section3 The XQuery for finding global variables
@@ -85,7 +88,7 @@
     description. Here is our XQuery source. We walk through it in
     \l{XQuery Code Walk-Through}.
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/reportGlobals.xq
+    \quotefromfile xquery/globalVariables/reportGlobals.xq
     \printuntil
 
     \section3 Running the XQuery
@@ -93,7 +96,7 @@
     To run the XQuery using the \c xmlpatterns command line utility,
     enter the following command:
 
-    \code
+    \badcode
     xmlpatterns reportGlobals.xq -param fileToOpen=globals.gccxml -output globals.html
     \endcode
 
@@ -128,7 +131,7 @@
     \c{examples/xmlpatterns/xquery/globalVariables/reportGlobals.xq}
     It begins with two variable declarations that begin the XQuery:
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/reportGlobals.xq
+    \quotefromfile xquery/globalVariables/reportGlobals.xq
     \skipto declare variable
     \printto (:
 
@@ -149,7 +152,7 @@
     instructions for displaying the text, and then the \c{<body>}
     element.
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/reportGlobals.xq
+    \quotefromfile xquery/globalVariables/reportGlobals.xq
     \skipto <html xmlns
     \printuntil
 
@@ -158,7 +161,7 @@
     the two \c{return} clauses separated by the \e {comma operator}
     about halfway down:
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/reportGlobals.xq
+    \quotefromfile xquery/globalVariables/reportGlobals.xq
     \skipto declare function local:report()
     \printuntil };
 
@@ -172,7 +175,7 @@
     Here is the html generated for the \c{<body>} element. Compare
     it with the XQuery code above:
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/globals.html
+    \quotefromfile xquery/globalVariables/globals.html
     \skipto <body>
     \printuntil </body>
 
@@ -181,21 +184,21 @@
     returns true if the variable has a complex type. The variable can
     be mutable or const.
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/reportGlobals.xq
+    \quotefromfile xquery/globalVariables/reportGlobals.xq
     \skipto declare function local:isComplexType
     \printuntil };
 
     \c{isPrimitive()} returns true if the variable has a primitive
     type. The variable must be mutable.
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/reportGlobals.xq
+    \quotefromfile xquery/globalVariables/reportGlobals.xq
     \skipto declare function local:isPrimitive
     \printuntil };
 
     \c{location()} returns a text constructed from the variable's file
     and line number attributes.
 
-    \quotefromfile xmlpatterns/xquery/globalVariables/reportGlobals.xq
+    \quotefromfile xquery/globalVariables/reportGlobals.xq
     \skipto declare function local:location
     \printuntil };
 
diff --git a/src/xmlpatterns/api/qxmlschema.cpp b/src/xmlpatterns/api/qxmlschema.cpp
index a050a80..62dc3d1 100644
--- a/src/xmlpatterns/api/qxmlschema.cpp
+++ b/src/xmlpatterns/api/qxmlschema.cpp
@@ -63,7 +63,7 @@ QT_BEGIN_NAMESPACE
   This class is used to represent schemas that conform to the \l{XML Schema} 1.0
   specification.
 
-  \sa QXmlSchemaValidator, {xmlpatterns/schema}{XML Schema Validation Example}
+  \sa QXmlSchemaValidator, {schema}{XML Schema Validation Example}
 */
 
 /*!
diff --git a/src/xmlpatterns/api/qxmlschemavalidator.cpp b/src/xmlpatterns/api/qxmlschemavalidator.cpp
index da0ed3a..3783520 100644
--- a/src/xmlpatterns/api/qxmlschemavalidator.cpp
+++ b/src/xmlpatterns/api/qxmlschemavalidator.cpp
@@ -69,7 +69,7 @@ QT_BEGIN_NAMESPACE
   This class implements schema validation according to the \l{XML Schema} 1.0
   specification.
 
-  \sa QXmlSchema, {xmlpatterns/schema}{XML Schema Validation Example}
+  \sa QXmlSchema, {schema}{XML Schema Validation Example}
 */
 
 /*!
diff --git a/src/xmlpatterns/doc/qtxmlpatterns.qdocconf b/src/xmlpatterns/doc/qtxmlpatterns.qdocconf
index dc0a265..4ff60e5 100644
--- a/src/xmlpatterns/doc/qtxmlpatterns.qdocconf
+++ b/src/xmlpatterns/doc/qtxmlpatterns.qdocconf
@@ -1,15 +1,13 @@
 include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf)
 
-# Name of the project which must match the outputdir. Determines the .index file
 project = QtXmlPatterns
+description = Qt XML Patterns Reference Documentation
+version = $QT_VERSION
 
-# Directories in which to search for files to document and images.
-# By default set to the root directory of the project for sources
-# and headers and qdoc will therefore generate output for each file.
-# Images should be placed in <rootdir>/dic/images and examples in
-# <rootdir>/examples.
-# Paths are relative to the  location of this file.
-exampledirs += ../../../examples \
+examplesinstallpath = xmlpatterns
+
+exampledirs += ../../../examples/xmlpatterns \
+               ../ \
                snippets
 
 headerdirs += ..
@@ -18,33 +16,23 @@ sourcedirs += ..
 
 depends += qtcore qtxml qtwidgets qtdesigner qtdoc
 
-# The following parameters are for creating a qhp file, the qhelpgenerator
-# program can convert the qhp file into a qch file which can be opened in
-# Qt Assistant and/or Qt Creator.
-
-# Defines the name of the project. You cannot use operators (+, =, -) in
-# the name. Properties for this project are set using a qhp.<projectname>.property
-# format.
 qhp.projects = QtXmlPatterns
 
-# Sets the name of the output qhp file.
 qhp.QtXmlPatterns.file = qtxmlpatterns.qhp
-
-# Namespace for the output file. This namespace is used to distinguish between
-# different documentation files in Creator/Assistant.
 qhp.QtXmlPatterns.namespace = org.qt-project.qtxmlpatterns.$QT_VERSION_TAG
-
-# Title for the package, will be the main title for the package in
-# Assistant/Creator.
 qhp.QtXmlPatterns.indexTitle = Qt XML Patterns
-
-# Only update the name of the project for the next variables.
 qhp.QtXmlPatterns.virtualFolder  = qtxmlpatterns
+
 qhp.QtXmlPatterns.subprojects = classes
 qhp.QtXmlPatterns.subprojects.classes.title = C++ Classes
 qhp.QtXmlPatterns.subprojects.classes.indexTitle = Qt XML Patterns C++ Classes
 qhp.QtXmlPatterns.subprojects.classes.selectors = class fake:headerfile
 qhp.QtXmlPatterns.subprojects.classes.sortPages = true
 
+tagfile                 = ../../../doc/qtxmlpatterns/qtxmlpatterns.tags
+
+# Use a generic thumbnail image for examples that have no images in their docs
+manifestmeta.thumbnail.names += "QtXmlPatterns/C++ Source Code Analyzer Example"
+
 navigation.landingpage = "Qt XML Patterns"
 navigation.cppclassespage = "Qt XML Patterns C++ Classes"
diff --git a/src/xmlpatterns/doc/src/qtxmlpatterns-examples.qdoc b/src/xmlpatterns/doc/src/qtxmlpatterns-examples.qdoc
new file mode 100644
index 0000000..f0da710
--- /dev/null
+++ b/src/xmlpatterns/doc/src/qtxmlpatterns-examples.qdoc
@@ -0,0 +1,34 @@
+/****************************************************************************
+**
+** 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$
+**
+****************************************************************************/
+/*!
+    \group xmlpattern_examples
+    \title Qt XML Patterns Examples
+    \brief Examples in the Qt XML Patterns module.
+    \ingroup all-examples
+
+    These are the examples available in the \l{Qt XML Patterns} module.
+*/
diff --git a/src/xmlpatterns/doc/src/qtxmlpatterns-index.qdoc b/src/xmlpatterns/doc/src/qtxmlpatterns-index.qdoc
index f9c6f16..a195767 100644
--- a/src/xmlpatterns/doc/src/qtxmlpatterns-index.qdoc
+++ b/src/xmlpatterns/doc/src/qtxmlpatterns-index.qdoc
@@ -1,6 +1,6 @@
 /****************************************************************************
 **
-** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies).
+** 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.
@@ -52,6 +52,12 @@
     \li \l{XQuery} - general overviews of XQuery and XSchema
     \endlist
 
+    \section1 Examples
+
+    \list
+    \li \l{Qt XML Patterns Examples}
+    \endlist
+
     \section1 API Reference
 
     These are links to the API reference materials.