Doc: Fix example documentation and paths

To fix issues related to example documentation and to follow Qt
convention, do the following changes:
    - Rename examples/qwebchannel to examples/webchannel
    - Move example-specific documentation to correct location(s)
    - Include generic 'Running the Example' instructions
    - Add the module name to example title, fix links

This ensures that example docs are built and the example manifest
file generated correctly.

Change-Id: I284e0b13db95a6738d72258735018b59156cc7da
Reviewed-by: Milian Wolff <milian.wolff@kdab.com>

18 files changed, 8 insertions, 53 deletions

diff --git a/examples/examples.pro b/examples/examples.pro
index 1cb6c9f..657e144 100644
--- a/examples/examples.pro
+++ b/examples/examples.pro
@@ -1,3 +1,3 @@
 TEMPLATE = subdirs
 
-SUBDIRS += qwebchannel
+SUBDIRS += webchannel
diff --git a/examples/qwebchannel/doc/examples.qdoc b/examples/qwebchannel/doc/examples.qdoc
deleted file mode 100644
index 613d760..0000000
--- a/examples/qwebchannel/doc/examples.qdoc
+++ /dev/null
@@ -1,49 +0,0 @@
-/****************************************************************************
-**
-** Copyright (C) 2014 Klarälvdalens Datakonsult AB, a KDAB Group company, info@kdab.com, author Milian Wolff <milian.wolff@kdab.com>
-** Contact: http://www.qt-project.org/legal
-**
-** This file is part of the QtWebChannel module of the Qt Toolkit.
-**
-** $QT_BEGIN_LICENSE:LGPL$
-** 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 Lesser General Public License Usage
-** Alternatively, this file may be used under the terms of the GNU Lesser
-** General Public License version 2.1 as published by the Free Software
-** Foundation and appearing in the file LICENSE.LGPL included in the
-** packaging of this file.  Please review the following information to
-** ensure the GNU Lesser General Public License version 2.1 requirements
-** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
-**
-** In addition, as a special exception, Digia gives you certain additional
-** rights.  These rights are described in the Digia Qt LGPL Exception
-** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
-**
-** GNU General Public License Usage
-** Alternatively, this file may be used under the terms of the GNU
-** General Public License version 3.0 as published by the Free Software
-** Foundation and appearing in the file LICENSE.GPL included in the
-** packaging of this file.  Please review the following information to
-** ensure the GNU General Public License version 3.0 requirements will be
-** met: http://www.gnu.org/copyleft/gpl.html.
-**
-**
-** $QT_END_LICENSE$
-**
-****************************************************************************/
-
-/*!
-    \title Qt WebChannel Examples
-    \group qtwebchannel-examples
-    \brief List of Qt WebChannel examples.
-
-    The examples show how to use the QWebChannel C++ and WebChannel QML API.
-
-*/
diff --git a/examples/qwebchannel/exampleassets.pri b/examples/webchannel/exampleassets.pri
index 035ca12..035ca12 100644
--- a/examples/qwebchannel/exampleassets.pri
+++ b/examples/webchannel/exampleassets.pri
diff --git a/examples/qwebchannel/nodejs/README b/examples/webchannel/nodejs/README
index 07f8fd8..07f8fd8 100644
--- a/examples/qwebchannel/nodejs/README
+++ b/examples/webchannel/nodejs/README
diff --git a/examples/qwebchannel/nodejs/chatclient.js b/examples/webchannel/nodejs/chatclient.js
index 03ce214..03ce214 100644
--- a/examples/qwebchannel/nodejs/chatclient.js
+++ b/examples/webchannel/nodejs/chatclient.js
diff --git a/examples/qwebchannel/nodejs/nodejs.pro b/examples/webchannel/nodejs/nodejs.pro
index 4df94d2..4df94d2 100644
--- a/examples/qwebchannel/nodejs/nodejs.pro
+++ b/examples/webchannel/nodejs/nodejs.pro
diff --git a/examples/qwebchannel/nodejs/package.json b/examples/webchannel/nodejs/package.json
index 2d863cc..2d863cc 100644
--- a/examples/qwebchannel/nodejs/package.json
+++ b/examples/webchannel/nodejs/package.json
diff --git a/examples/qwebchannel/standalone/dialog.ui b/examples/webchannel/standalone/dialog.ui
index 056a3f5..056a3f5 100644
--- a/examples/qwebchannel/standalone/dialog.ui
+++ b/examples/webchannel/standalone/dialog.ui
diff --git a/examples/qwebchannel/doc/standalone-screenshot.png b/examples/webchannel/standalone/doc/images/standalone-screenshot.png
index 3c55e19..3c55e19 100644
--- a/examples/qwebchannel/doc/standalone-screenshot.png
+++ b/examples/webchannel/standalone/doc/images/standalone-screenshot.png
diff --git a/examples/qwebchannel/doc/standalone.qdoc b/examples/webchannel/standalone/doc/src/standalone.qdoc
index 1d81dad..46c09c3 100644
--- a/examples/qwebchannel/doc/standalone.qdoc
+++ b/examples/webchannel/standalone/doc/src/standalone.qdoc
@@ -41,7 +41,7 @@
 
 /*!
     \example standalone
-    \title Standalone Example
+    \title Qt WebChannel Standalone Example
     \ingroup qtwebchannel-examples
     \image standalone-screenshot.png
     \brief Shows how to use the QWebChannel C++ API to communicate with an external client.
@@ -49,11 +49,15 @@
     The standalone example is a simple chat between a pure C++/Qt application and a remote HTML
     client running in your default browser.
 
-    The C++ app sets up a QWebChannel and publishes a Dialog object over it.
+    \include examples-run.qdocinc
+
+    \section1 Overview
+
+    The C++ application sets up a QWebChannel instance and publishes a Dialog object over it.
     For the remote client side, \c index.html is opened. Both show a dialog with the list of
     received messages and an input box to send messages to the other end.
 
-    The Dialog emits the Dialog::sendText() signal when the user sents a message. The signal
+    The Dialog emits the Dialog::sendText() signal when the user sends a message. The signal
     automatically gets propagated to the HTML client. When the user enters a message on the HTML
     side, Dialog::receiveText() is called.
 
diff --git a/examples/qwebchannel/standalone/index.html b/examples/webchannel/standalone/index.html
index 778a502..778a502 100644
--- a/examples/qwebchannel/standalone/index.html
+++ b/examples/webchannel/standalone/index.html
diff --git a/examples/qwebchannel/standalone/main.cpp b/examples/webchannel/standalone/main.cpp
index 2cbc6b8..2cbc6b8 100644
--- a/examples/qwebchannel/standalone/main.cpp
+++ b/examples/webchannel/standalone/main.cpp
diff --git a/examples/qwebchannel/standalone/standalone.pro b/examples/webchannel/standalone/standalone.pro
index fdeb87a..fdeb87a 100644
--- a/examples/qwebchannel/standalone/standalone.pro
+++ b/examples/webchannel/standalone/standalone.pro
diff --git a/examples/qwebchannel/standalone/websocketclientwrapper.cpp b/examples/webchannel/standalone/websocketclientwrapper.cpp
index 0e776e1..0e776e1 100644
--- a/examples/qwebchannel/standalone/websocketclientwrapper.cpp
+++ b/examples/webchannel/standalone/websocketclientwrapper.cpp
diff --git a/examples/qwebchannel/standalone/websocketclientwrapper.h b/examples/webchannel/standalone/websocketclientwrapper.h
index 1f742f7..1f742f7 100644
--- a/examples/qwebchannel/standalone/websocketclientwrapper.h
+++ b/examples/webchannel/standalone/websocketclientwrapper.h
diff --git a/examples/qwebchannel/standalone/websockettransport.cpp b/examples/webchannel/standalone/websockettransport.cpp
index 5714463..5714463 100644
--- a/examples/qwebchannel/standalone/websockettransport.cpp
+++ b/examples/webchannel/standalone/websockettransport.cpp
diff --git a/examples/qwebchannel/standalone/websockettransport.h b/examples/webchannel/standalone/websockettransport.h
index 828ac00..828ac00 100644
--- a/examples/qwebchannel/standalone/websockettransport.h
+++ b/examples/webchannel/standalone/websockettransport.h
diff --git a/examples/qwebchannel/qwebchannel.pro b/examples/webchannel/webchannel.pro
index de6b4b8..de6b4b8 100644
--- a/examples/qwebchannel/qwebchannel.pro
+++ b/examples/webchannel/webchannel.pro