Doc: Fix example pages for Qt Tools

Use the \group and \ingroup commands to produce Qt 5 style
example pages. Unify the file structure for example docs.
Add example page for Qt Help and move Context Sensitive Help
example to it (from the Qt Assistant Examples page).

Change-Id: I687b18a134037588a5a536fe2353c18dfd44b1d7
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
Reviewed-by: David Schulz <david.schulz@digia.com>

examples/assistant/assistant.pro

 TEMPLATE = subdirs
 CONFIG  += ordered
 
-SUBDIRS += simpletextviewer
+SUBDIRS += simpletextviewer \
+           remotecontrol

examples/assistant/doc/src/remotecontrol.qdoc

+/****************************************************************************
+**
+** Copyright (C) 2012 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$
+**
+****************************************************************************/
+
+/*!
+    \example remotecontrol
+    \ingroup examples-qtassistant
+    \title Remote Control Example
+
+    \brief Using and controlling Qt Assistant as a help viewer.
+*/

examples/assistant/simpletextviewer/doc/src/simpletextviewer.qdoc → examples/assistant/doc/src/simpletextviewer.qdoc

@@ -27,10 +27,10 @@
 
 /*!
     \example simpletextviewer
+    \ingroup examples-qtassistant
     \title Simple Text Viewer Example
 
-    \brief The Simple Text Viewer example shows how to use \QA as a customized
-    help viewer for your application.
+    \brief Using \QA as a customized help viewer for your application.
 
     \image simpletextviewer-example.png
 

examples/designer/doc/src/arthurplugin.qdoc

@@ -27,10 +27,10 @@
 
 /*!
     \example arthurplugin
+    \ingroup examples-designer
     \title Arthur Plugin
 
-    \brief In this example we demonstrate the abilities of Qt's painting system
-    in combination with \QD's custom widget plugin facilities.
+    \brief Using the Qt painting system with \QD custom widget plugins.
 
     \image arthurplugin-demo.png
 

examples/designer/doc/src/calculatorbuilder.qdoc

@@ -27,10 +27,10 @@
 
 /*!
     \example calculatorbuilder
+    \ingroup examples-designer
     \title Calculator Builder Example
 
-    \brief The Calculator Builder example shows how to create a user interface from
-    a \QD form at run-time, using the QUiLoader class.
+    \brief Creating a user interface from a \QD form at run-time.
 
     \image calculatorbuilder-example.png
 

examples/designer/doc/src/calculatorform.qdoc

@@ -27,9 +27,12 @@
 
 /*!
     \example calculatorform
+    \ingroup examples-designer
     \title Calculator Form Example
 
-    \brief The Calculator Form Example shows how to use a form created with
+    \brief Using a form created with \QD in an application.
+
+    The Calculator Form Example shows how to use a form created with
     \QD in an application by using the user interface information from
     a QWidget subclass.  We use \l{Using a Designer UI File in Your Application}
     {uic's auto-connection} feature to automatically connect signals

examples/designer/doc/src/containerextension.qdoc

@@ -27,10 +27,13 @@
 
 /*!
     \example containerextension
+    \ingroup examples-designer
     \title Container Extension Example
 
-    \brief The Container Extension example shows how to create a custom
-    multi-page plugin for Qt Designer using the
+    \brief Creating a custom multi-page plugin for \QD.
+
+    The Container Extension example shows how to create a custom multi-page
+    plugin for \QD using the
     QDesignerContainerExtension class.
 
     \image containerextension-example.png

examples/designer/doc/src/customwidgetplugin.qdoc

@@ -27,9 +27,10 @@
 
 /*!
     \example customwidgetplugin
+    \ingroup examples-designer
     \title Custom Widget Plugin Example
 
-    \brief The Custom Widget example shows how to create a custom widget plugin for \QD.
+    \brief Creating a custom widget plugin for Qt Designer.
 
     \image customwidgetplugin-example.png
 

examples/designer/doc/src/taskmenuextension.qdoc

@@ -27,9 +27,13 @@
 
 /*!
     \example taskmenuextension
+    \ingroup examples-designer
     \title Task Menu Extension Example
 
-    \brief The Task Menu Extension example shows how to create a custom
+    \brief Creating a custom widget plugin for \QD and providing custom task
+    menu entries that are associated with the plugin.
+
+    The Task Menu Extension example shows how to create a custom
     widget plugin for \l {Qt Designer Manual}{\QD}, and how to to use
     the QDesignerTaskMenuExtension class to provide custom task menu
     entries associated with the plugin.

examples/designer/doc/src/worldtimeclockbuilder.qdoc

@@ -27,11 +27,11 @@
 
 /*!
   \example worldtimeclockbuilder
+  \ingroup examples-designer
   \title World Time Clock Builder Example
 
-  \brief The World Time Clock Builder example shows how forms created with Qt
-  Designer that contain custom widgets can be dynamically generated at
-  run-time.
+  \brief Creating forms with Qt Designer that contain custom widgets that can be
+  dynamically generated at run-time.
 
   \image worldtimeclockbuilder-example.png