13 files changed, 17 insertions, 17 deletions
diff --git a/examples/designer/doc/src/arthurplugin.qdoc b/examples/designer/doc/src/arthurplugin.qdoc
index dedbd604d..5007e9c6a 100644
--- a/examples/designer/doc/src/arthurplugin.qdoc
+++ b/examples/designer/doc/src/arthurplugin.qdoc
@@ -29,7 +29,7 @@
     \example designer/arthurplugin
     \title Arthur Plugin
 
-    In this example we demonstrate the abilities of Qt's painting system
+    \brief In this example we demonstrate the abilities of Qt's painting system
     in combination with \QD's custom widget plugin facilities.
 
     \image arthurplugin-demo.png
diff --git a/examples/designer/doc/src/calculatorbuilder.qdoc b/examples/designer/doc/src/calculatorbuilder.qdoc
index ce62acc16..4db5da3a4 100644
--- a/examples/designer/doc/src/calculatorbuilder.qdoc
+++ b/examples/designer/doc/src/calculatorbuilder.qdoc
@@ -29,7 +29,7 @@
     \example designer/calculatorbuilder
     \title Calculator Builder Example
 
-    The Calculator Builder example shows how to create a user interface from
+    \brief The Calculator Builder example shows how to create a user interface from
     a \QD form at run-time, using the QUiLoader class.
 
     \image calculatorbuilder-example.png
diff --git a/examples/designer/doc/src/calculatorform.qdoc b/examples/designer/doc/src/calculatorform.qdoc
index 2fb033c4b..b03cc7fc6 100644
--- a/examples/designer/doc/src/calculatorform.qdoc
+++ b/examples/designer/doc/src/calculatorform.qdoc
@@ -29,7 +29,7 @@
     \example designer/calculatorform
     \title Calculator Form Example
 
-    The Calculator Form Example shows how to use a form created with
+    \brief 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
diff --git a/examples/designer/doc/src/containerextension.qdoc b/examples/designer/doc/src/containerextension.qdoc
index 4836db11d..cce69edf0 100644
--- a/examples/designer/doc/src/containerextension.qdoc
+++ b/examples/designer/doc/src/containerextension.qdoc
@@ -29,7 +29,7 @@
     \example designer/containerextension
     \title Container Extension Example
 
-    The Container Extension example shows how to create a custom
+    \brief The Container Extension example shows how to create a custom
     multi-page plugin for Qt Designer using the
     QDesignerContainerExtension class.
 
diff --git a/examples/designer/doc/src/customwidgetplugin.qdoc b/examples/designer/doc/src/customwidgetplugin.qdoc
index 51765568c..bd1e76d0f 100644
--- a/examples/designer/doc/src/customwidgetplugin.qdoc
+++ b/examples/designer/doc/src/customwidgetplugin.qdoc
@@ -29,7 +29,7 @@
     \example designer/customwidgetplugin
     \title Custom Widget Plugin Example
 
-    The Custom Widget example shows how to create a custom widget plugin for \QD.
+    \brief The Custom Widget example shows how to create a custom widget plugin for \QD.
 
     \image customwidgetplugin-example.png
 
diff --git a/examples/designer/doc/src/taskmenuextension.qdoc b/examples/designer/doc/src/taskmenuextension.qdoc
index f42887345..35f2970c8 100644
--- a/examples/designer/doc/src/taskmenuextension.qdoc
+++ b/examples/designer/doc/src/taskmenuextension.qdoc
@@ -29,7 +29,7 @@
     \example designer/taskmenuextension
     \title Task Menu Extension Example
 
-    The Task Menu Extension example shows how to create a custom
+    \brief 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.
diff --git a/examples/designer/doc/src/worldtimeclockbuilder.qdoc b/examples/designer/doc/src/worldtimeclockbuilder.qdoc
index 1f2f055d9..2c0445d7e 100644
--- a/examples/designer/doc/src/worldtimeclockbuilder.qdoc
+++ b/examples/designer/doc/src/worldtimeclockbuilder.qdoc
@@ -29,7 +29,7 @@
   \example designer/worldtimeclockbuilder
   \title World Time Clock Builder Example
 
-  The World Time Clock Builder example shows how forms created with Qt
+  \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.
 
diff --git a/examples/designer/doc/src/worldtimeclockplugin.qdoc b/examples/designer/doc/src/worldtimeclockplugin.qdoc
index 57ce8d9f3..8bcb6ced2 100644
--- a/examples/designer/doc/src/worldtimeclockplugin.qdoc
+++ b/examples/designer/doc/src/worldtimeclockplugin.qdoc
@@ -29,7 +29,7 @@
     \example designer/worldtimeclockplugin
     \title World Time Clock Plugin Example
 
-    The World Time Clock Plugin example shows how to create a custom
+    \brief The World Time Clock Plugin example shows how to create a custom
     widget plugin for \QD that uses signals and slots.
 
     \image worldtimeclockplugin-example.png
diff --git a/examples/help/simpletextviewer/doc/src/simpletextviewer.qdoc b/examples/help/simpletextviewer/doc/src/simpletextviewer.qdoc
index 63ea51a4b..dd8904721 100644
--- a/examples/help/simpletextviewer/doc/src/simpletextviewer.qdoc
+++ b/examples/help/simpletextviewer/doc/src/simpletextviewer.qdoc
@@ -29,15 +29,15 @@
     \example help/simpletextviewer
     \title Simple Text Viewer Example
 
-    The Simple Text Viewer example shows how to use \QA as a customized
+    \brief The Simple Text Viewer example shows how to use \QA as a customized
     help viewer for your application.
 
+    \image simpletextviewer-example.png
+
     This is done in two stages. Firstly, documentation is created and \QA
     is customized; secondly, the functionality to launch and control
     \QA is added to the application.
 
-    \image simpletextviewer-example.png
-
     The Simple Text Viewer application lets the user select and view
     existing files.
 
diff --git a/examples/linguist/doc/src/arrowpad.qdoc b/examples/linguist/doc/src/arrowpad.qdoc
index 6e0ae5d0d..dec7fd624 100644
--- a/examples/linguist/doc/src/arrowpad.qdoc
+++ b/examples/linguist/doc/src/arrowpad.qdoc
@@ -29,7 +29,7 @@
     \example arrowpad
     \title Arrow Pad Example
 
-    This example is a slightly more involved and introduces a key \e
+    \brief This example is a slightly more involved and introduces a key \e
     {Qt Linguist} concept: "contexts". It also shows how to use two
     or more languages.
 
diff --git a/examples/linguist/doc/src/hellotr.qdoc b/examples/linguist/doc/src/hellotr.qdoc
index 023e41bd7..5e34031ed 100644
--- a/examples/linguist/doc/src/hellotr.qdoc
+++ b/examples/linguist/doc/src/hellotr.qdoc
@@ -29,8 +29,8 @@
     \example hellotr
     \title Hello tr() Example
 
-    This example is a small Hello World program with a Latin translation. The
-    screenshot below shows the English version.
+    \brief This example is a small Hello World program with a Latin translation. The
+    screenshot shows the English version.
 
     \image linguist-hellotr_en.png
 
diff --git a/examples/linguist/doc/src/trollprint.qdoc b/examples/linguist/doc/src/trollprint.qdoc
index f6fbc5e3c..fe4857544 100644
--- a/examples/linguist/doc/src/trollprint.qdoc
+++ b/examples/linguist/doc/src/trollprint.qdoc
@@ -29,7 +29,7 @@
     \example trollprint
     \title Troll Print Example
 
-    Troll Print is an example application that lets the user choose
+    \brief Troll Print is an example application that lets the user choose
     printer settings. It comes in two versions: English and
     Portuguese.
 
diff --git a/src/designer/src/lib/uilib/container.qdoc b/src/designer/src/lib/uilib/container.qdoc
index 42a832085..95ef518e0 100644
--- a/src/designer/src/lib/uilib/container.qdoc
+++ b/src/designer/src/lib/uilib/container.qdoc
@@ -31,13 +31,13 @@
     a custom multi-page container in Qt Designer's workspace.
     \inmodule QtDesigner
 
+    \image containerextension-example.png
+
     QDesignerContainerExtension provide an interface for creating
     custom container extensions. A container extension consists of a
     collection of functions that \QD needs to manage a multi-page
     container plugin, and a list of the container's pages.
 
-    \image containerextension-example.png
-
     \warning This is \e not an extension for container plugins in
     general, only custom \e multi-page containers.