QDoc documentation: modified the instructions for documenting signals.

-we document signals, not signal handlers.

Change-Id: I7d52223a393ff0530ead06dfb8a80479e34fd362
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>
Reviewed-by: Martin Smith <martin.smith@nokia.com>

src/tools/qdoc/doc/qdoc-manual.qdoc

@@ -5551,25 +5551,18 @@
     \target qmlsignal-command
     \section1 \\qmlsignal
 
-    The \\qmlsignal command is for documenting a
+    The \\qmlsignal command is for documenting a QML signal.
-    \l{http://doc.qt.nokia.com/4.7/qdeclarativeintroduction.html#signal-handlers}
+    The argument is the rest of the line. The arguments should be: the QML type
-    {signal handler}.
+    where the signal is declared, the \c{::} qualifier, and finally the signal
-    The argument is the rest of the line. It should be the QML type where the
+    name. If we have a QML signal named \c clicked(), the documentation for it
-    signal handler is declared, the \c{::} qualifier, and finally the signal
+    would look like this:
-    handler name. If we have a QML signal handler named \c onAdd() in QML
-    element \c MouseArea, the \\qmlsignal for it would look like this:
 
     \code
     / *!
-        \qmlsignal MouseArea::onEntered()
+    \qmlsignal UIComponents::Button::clicked()
-
+    This signal is emitted when the user clicks the button. A click is defined
-        This handler is called when the mouse enters the mouse area.
+    as a press followed by a release. The corresponding handler is
-
+    \c onClicked.
-        By default the onEntered handler is only called while a button is
-        pressed. Setting hoverEnabled to true enables handling of
-        onEntered when no mouse button is pressed.
-
-        \sa hoverEnabled
     * /
     \endcode