Doc: Fix example pages for Qt Tools
authorLeena Miettinen <riitta-leena.miettinen@digia.com>
Tue, 11 Dec 2012 16:31:48 +0000 (17:31 +0100)
committerThe Qt Project <gerrit-noreply@qt-project.org>
Wed, 12 Dec 2012 06:51:36 +0000 (07:51 +0100)
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>
30 files changed:
examples/assistant/assistant.pro
examples/assistant/doc/images/simpletextviewer-example.png [moved from examples/assistant/simpletextviewer/doc/images/simpletextviewer-example.png with 100% similarity]
examples/assistant/doc/images/simpletextviewer-findfiledialog.png [moved from examples/assistant/simpletextviewer/doc/images/simpletextviewer-findfiledialog.png with 100% similarity]
examples/assistant/doc/images/simpletextviewer-mainwindow.png [moved from examples/assistant/simpletextviewer/doc/images/simpletextviewer-mainwindow.png with 100% similarity]
examples/assistant/doc/src/remotecontrol.qdoc [new file with mode: 0644]
examples/assistant/doc/src/simpletextviewer.qdoc [moved from examples/assistant/simpletextviewer/doc/src/simpletextviewer.qdoc with 99% similarity]
examples/assistant/remotecontrol/enter.png [moved from examples/help/remotecontrol/enter.png with 100% similarity]
examples/assistant/remotecontrol/main.cpp [moved from examples/help/remotecontrol/main.cpp with 100% similarity]
examples/assistant/remotecontrol/remotecontrol.cpp [moved from examples/help/remotecontrol/remotecontrol.cpp with 100% similarity]
examples/assistant/remotecontrol/remotecontrol.h [moved from examples/help/remotecontrol/remotecontrol.h with 100% similarity]
examples/assistant/remotecontrol/remotecontrol.pro [moved from examples/help/remotecontrol/remotecontrol.pro with 100% similarity]
examples/assistant/remotecontrol/remotecontrol.qrc [moved from examples/help/remotecontrol/remotecontrol.qrc with 100% similarity]
examples/assistant/remotecontrol/remotecontrol.ui [moved from examples/help/remotecontrol/remotecontrol.ui with 100% similarity]
examples/designer/doc/src/arthurplugin.qdoc
examples/designer/doc/src/calculatorbuilder.qdoc
examples/designer/doc/src/calculatorform.qdoc
examples/designer/doc/src/containerextension.qdoc
examples/designer/doc/src/customwidgetplugin.qdoc
examples/designer/doc/src/taskmenuextension.qdoc
examples/designer/doc/src/worldtimeclockbuilder.qdoc
examples/designer/doc/src/worldtimeclockplugin.qdoc
examples/help/doc/src/contextsensitivehelp.qdoc [new file with mode: 0644]
examples/help/help.pro
examples/uitools/doc/src/multipleinheritance.qdoc
examples/uitools/doc/src/textfinder.qdoc
src/assistant/assistant/doc/src/assistant-example.qdoc
src/assistant/help/doc/qthelp.qdocconf
src/assistant/help/doc/src/qthelp-examples.qdoc [new file with mode: 0644]
src/designer/src/designer/doc/src/designer-examples.qdoc
src/designer/src/uitools/doc/src/qtuitools-examples.qdoc

index fd289a6..578c7ff 100644 (file)
@@ -1,4 +1,5 @@
 TEMPLATE = subdirs
 CONFIG  += ordered
 
-SUBDIRS += simpletextviewer
+SUBDIRS += simpletextviewer \
+           remotecontrol
diff --git a/examples/assistant/doc/src/remotecontrol.qdoc b/examples/assistant/doc/src/remotecontrol.qdoc
new file mode 100644 (file)
index 0000000..5a8106f
--- /dev/null
@@ -0,0 +1,34 @@
+/****************************************************************************
+**
+** 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.
+*/
 
 /*!
     \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
 
index 0f116e7..9dbfaa7 100644 (file)
 
 /*!
     \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
 
index b845354..cb6f6f4 100644 (file)
 
 /*!
     \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
 
index 063086b..68e47c1 100644 (file)
 
 /*!
     \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
index 093993a..5b1b551 100644 (file)
 
 /*!
     \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
index 3206136..b96b3d3 100644 (file)
 
 /*!
     \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
 
index ee80bad..b40e7b8 100644 (file)
 
 /*!
     \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.
index 721d59e..980c0f6 100644 (file)
 
 /*!
   \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
 
index 58770a4..4d3042b 100644 (file)
 
 /*!
     \example worldtimeclockplugin
+    \ingroup examples-designer
     \title World Time Clock Plugin Example
 
-    \brief The World Time Clock Plugin example shows how to create a custom
-    widget plugin for \QD that uses signals and slots.
+    \brief Creating a custom widget plugin for \QD that uses signals and slots.
 
     \image worldtimeclockplugin-example.png
 
diff --git a/examples/help/doc/src/contextsensitivehelp.qdoc b/examples/help/doc/src/contextsensitivehelp.qdoc
new file mode 100644 (file)
index 0000000..2e98caf
--- /dev/null
@@ -0,0 +1,35 @@
+/****************************************************************************
+**
+** 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 contextsensitivehelp
+    \ingroup examples-qthelp
+    \title Context-Sensitive Help Example
+
+    \brief Using the QHelpEngineCore class to implement context-sensitive help
+    for applications.
+*/
index c98aad8..49aae93 100644 (file)
@@ -1,5 +1,4 @@
 TEMPLATE = subdirs
 CONFIG  += ordered
 
-SUBDIRS += contextsensitivehelp \
-           remotecontrol
+SUBDIRS += contextsensitivehelp
index aec4da9..ca3ade2 100644 (file)
 
 /*!
     \example multipleinheritance
+    \ingroup examples-qtuitools
     \title Multiple Inheritance Example
 
+    \brief Using a form created with Qt Designer in an application.
+
     The Multiple Inheritance Example shows how to use a form created with
     Qt Designer in an application by subclassing both QWidget and the user
     interface class, which is \c{Ui::CalculatorForm}.
index c05e350..7552b08 100644 (file)
 
 /*!
     \example textfinder
+    \ingroup examples-qtuitools
     \title Text Finder Example
 
-    \brief The Text Finder example demonstrates how to dynamically process forms
-    using the Qt UI Tools module. Dynamic form processing enables a form to
+    \brief Dynamically processing forms using Qt UI Tools.
+
+    Dynamic form processing enables a form to
     be processed at run-time only by changing the UI file for the project.
     The program allows the user to look up a particular word within the
     contents of a text file. This text file is included in the project's
index 5cc03ef..f107202 100644 (file)
 ****************************************************************************/
 
 /*!
-    \group examples-qtassistant.html
+    \group examples-qtassistant
     \ingroup all-examples
     \title Qt Assistant Examples
-    \brief Adding interactive help to your Qt application.
+    \brief Using Qt Assistant as a help viewer for  Qt applications.
 
-    \image assistant-examples.png HelpSystem
+    \image assistant-examples.png
 
-    Support for interactive help is provided by the Qt Assistant application.
-    Developers can take advantages of the facilities it offers to display
-    specially-prepared documentation to users of their applications.
+    Qt Assistant provides support for interactive help and enables you to
+    display customer documentation to users of your Qt applications.
 
+    The following examples illustrate how to use Qt Assistant as a help viewer
+    for applications.
+
+*/
+
+/*
     \list
     \li \l{simpletextviewer}{Simple Text Viewer}\raisedaster
-    \li \l{help/remotecontrol}{Remote Control}
-    \li \l{help/contextsensitivehelp}{Context-Sensitive Help}
+    \li \l{remotecontrol}{Remote Control}
     \endlist
 
     Examples marked with an asterisk (*) are fully documented.
index c8cd0c9..2ac84c1 100644 (file)
@@ -32,7 +32,7 @@ headerdirs += ..
 
 sourcedirs              = ..
 
-exampledirs             = ../../../../../examples/help \
+exampledirs             = ../../../../examples/help \
                           snippets
 
 imagedirs               = images
diff --git a/src/assistant/help/doc/src/qthelp-examples.qdoc b/src/assistant/help/doc/src/qthelp-examples.qdoc
new file mode 100644 (file)
index 0000000..d6f441e
--- /dev/null
@@ -0,0 +1,47 @@
+/****************************************************************************
+**
+** 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$
+**
+****************************************************************************/
+
+/*!
+    \group examples-qthelp
+    \ingroup all-examples
+    \title Qt Help Examples
+    \brief Adding context-sensitive help to Qt applications.
+
+    The Qt help system includes tools for generating and viewing Qt help files.
+    In addition, it provides classes for accessing help contents programatically
+    to be able to integrate online help into Qt applications.
+
+    The following example illustrates how to add context-sensitive help to
+    applications.
+
+*/
+
+/*
+    \list
+    \li \l{contextsensitivehelp}{Context-Sensitive Help}
+    \endlist
+*/
index 0b649b0..1dce46e 100644 (file)
@@ -26,7 +26,7 @@
 ****************************************************************************/
 
 /*!
-    \group examples-designer.html
+    \group examples-designer
     \ingroup all-examples
     \title Qt Designer Examples
     \brief Using Qt Designer to build your UI.
     create and configure forms without writing code. GUIs created with
     Qt Designer can be compiled into an application or created at run-time.
 
+    The following examples illustrate how to create and use Qt Designer forms
+    and how to create Qt Designer custom widget plugins.
+*/
+
+/*
     \list
     \li \l{arthurplugin}{Arthur Plugin}
     \li \l{calculatorbuilder}{Calculator Builder}\raisedaster
index 1500064..45044d6 100644 (file)
 ****************************************************************************/
 
 /*!
-    \group examples-qtuitools.html
+    \group examples-qtuitools
     \ingroup all-examples
     \title Qt UI Tools Examples
     \brief Using Qt UI Tools to process UI forms.
 
     \image uitools-examples.png UiTools
 
+    The \l{Qt UI Tools} module provides classes to handle UI forms created with
+    Qt Designer. The forms are processed at run-time to dynamically generate
+    user interfaces.
+
+    The following examples illustrate how to use Qt UI Tools to process UI
+    forms.
+*/
+
+/*
     \list
         \li \l{Multiple Inheritance Example}\raisedaster
         \li \l{Text Finder Example}\raisedaster
-        \li \l{Calculator Builder Example}\raisedaster
-        \li \l{World Time Clock Builder Example}\raisedaster
     \endlist
 
     Examples marked with an asterisk (*) are fully documented.