move documentation mainpage to doc/index.doc

2 files changed, 42 insertions, 1 deletions

diff --git a/doc/doxyfilter.cpp b/doc/doxyfilter.cpp
index d935050b..854f2332 100644
--- a/doc/doxyfilter.cpp
+++ b/doc/doxyfilter.cpp
@@ -75,7 +75,7 @@ int main(int argc, char *argv[])
         setField(code, "HIDE_UNDOC_CLASSES", "YES");
         setField(code, "GENERATE_LATEX", "NO");
         setField(code, "HTML_TIMESTAMP", "NO");
-        setField(code, "INPUT", "../src");
+        setField(code, "INPUT", "index.doc ../src");
         setField(code, "INPUT_FILTER", QString::fromLocal8Bit(argv[0]));
         setField(code, "PROJECT_NAME", "QXmpp");
         setField(code, "PROJECT_NUMBER", QString("Version: %1.%2.%3").arg(
diff --git a/doc/index.doc b/doc/index.doc
new file mode 100644
index 00000000..19941e6c
--- /dev/null
+++ b/doc/index.doc
@@ -0,0 +1,41 @@
+/*!
+    \mainpage
+
+    QXmpp is a cross-platform C++ XMPP client library based on the Qt
+    framework. It tries to use Qt's programming conventions in order to ease
+    the learning curve for new programmers.
+
+    QXmpp based clients are built using QXmppClient instances which handle the
+    establishment of the XMPP connection and provide a number of high-level
+    "managers" to perform specific tasks. You can write your own managers to
+    extend QXmpp by subclassing QXmppClientExtension.
+
+    <B>Main Class:</B>
+    - QXmppClient
+
+    <B>Managers to perform specific tasks:</B>
+    - QXmppRosterManager
+    - QXmppVCardManager
+    - QXmppTransferManager
+    - QXmppMucManager
+    - QXmppCallManager
+    - QXmppArchiveManager
+    - QXmppVersionManager
+    - QXmppDiscoveryManager
+    - QXmppEntityTimeManager
+
+    <B>XMPP stanzas:</B> If you are interested in a more low-level API, you can refer to these
+    classes.
+    - QXmppIq
+    - QXmppMessage
+    - QXmppPresence
+
+    <BR><BR>
+    <B>Project Details:</B>
+
+    Project Page: https://github.com/qxmpp-project/qxmpp/
+    <BR>
+    Report Issues: https://github.com/qxmpp-project/qxmpp/issues/
+    <BR>
+    New Releases: https://github.com/qxmpp-project/qxmpp/downloads/
+*/