Doc: landing and module page for Qt X11 Extras

Ingroup statement in qx11info_x11.cpp
Removed trailing whitespace

Change-Id: I03c16014f66a809f1c31b4501ffd1ca0691b5ee7
Reviewed-by: Martin Smith <martin.smith@digia.com>
Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>

3 files changed, 115 insertions, 2 deletions

diff --git a/src/x11extras/doc/src/qtx11extras-index.qdoc b/src/x11extras/doc/src/qtx11extras-index.qdoc
new file mode 100644
index 0000000..050c37f
--- /dev/null
+++ b/src/x11extras/doc/src/qtx11extras-index.qdoc
@@ -0,0 +1,61 @@
+/****************************************************************************
+**
+** Copyright (C) 2013 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$
+**
+****************************************************************************/
+/*!
+    \page qtx11extras-index.html
+    \title Qt X11 Extras
+    \brief A Qt module which provides tools for developing for the X11 platform.
+
+    Qt X11 Extras enables the Qt programmer to write applications for the Linux/X11
+    platform. Applications developed with Qt can also be deployed across several
+    other desktop and embedded operating systems without having to rewrite the source
+    code.
+
+    \section1 Getting Started
+
+    To include the definitions of the module's classes, use the
+    following directive:
+
+    \code
+    #include <qx11info_x11.h>
+    \endcode
+
+    To link against the module, add this line to your \l qmake \c
+    .pro file:
+
+    \code
+    QT+=qtx11extras
+    \endcode
+
+    Requirements for using X11 with Qt: \l{Qt for X11 Requirements}
+
+    \section1 API Reference
+
+    Links to the API reference materials:
+    \list
+    \li \l{Qt X11 Extras C++ Classes}{C++ Classes}
+    \endlist
+*/
diff --git a/src/x11extras/doc/src/qtx11extras-module.qdoc b/src/x11extras/doc/src/qtx11extras-module.qdoc
new file mode 100644
index 0000000..3b38b5a
--- /dev/null
+++ b/src/x11extras/doc/src/qtx11extras-module.qdoc
@@ -0,0 +1,51 @@
+/****************************************************************************
+**
+** Copyright (C) 2013 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$
+**
+****************************************************************************/
+
+/*!
+    \module QtX11Extras
+    \title Qt X11 Extras C++ Classes
+    \ingroup modules
+
+    \brief Provides classes for developing for the X11 platform.
+
+    To include the definitions of the module's classes, use the
+    following directive:
+
+    \code
+    #include <qx11info_x11.h>
+    \endcode
+
+    To link against the module, add this line to your \l qmake \c
+    .pro file:
+
+    \code
+    QT+=qtx11extras
+    \endcode
+
+
+*/
+
diff --git a/src/x11extras/qx11info_x11.cpp b/src/x11extras/qx11info_x11.cpp
index a7499e4..aa35ff1 100644
--- a/src/x11extras/qx11info_x11.cpp
+++ b/src/x11extras/qx11info_x11.cpp
@@ -62,8 +62,9 @@ QT_BEGIN_NAMESPACE
 
 /*!
     \class QX11Info
-    \brief The QX11Info class provides information about the X display
-    configuration.
+    \inmodule QtX11Extras
+    \since 5.1
+    \brief Provides information about the X display configuration.
 
     The class provides two APIs: a set of non-static functions that
     provide information about a specific widget or pixmap, and a set