diff --git a/Mainpage.dox b/Mainpage.dox
index 856b73847..c0d4e69bd 100644
--- a/Mainpage.dox
+++ b/Mainpage.dox
@@ -1,5 +1,19 @@
-/**
-* @mainpage KWin
-*
-* KDE Window Manager
-*/
\ No newline at end of file
+/** @mainpage KWin
+
+KWin is the KDE window manager.
+
+@authors
+Matthias Ettrich \<ettrich@kde.org\><br>
+Lubos Lunak \<l.lunak@kde.org\>
+
+@maintainers
+Lubos Lunak \<l.lunak@kde.org\>
+
+@licenses
+@gpl
+
+
+*/
+
+// DOXYGEN_SET_PROJECT_NAME = KWin
+// vim:ts=4:sw=4:expandtab:filetype=doxygen
diff --git a/lib/Mainpage.dox b/lib/Mainpage.dox
index 1366f475f..45a6fb872 100644
--- a/lib/Mainpage.dox
+++ b/lib/Mainpage.dox
@@ -1,7 +1,25 @@
-/**
-* @mainpage KWin Libraries
-*
-* This directory provides the interfaces for the window manager effects 
-* interface and the interface for window decorations.
-*
+/** @mainpage KWin Libraries
+
+There are two libraries provided: libkdecorations and libkwineffects.
+<p>
+libkdecorations is a library for implementing window decoration plugins
+for KWin.
+
+libkwineffects is a library for implementing window transition effect
+plugins for KWin.
+
+@authors
+Lubos Lunak \<l.lunak@kde.org\><br>
+Rivo Laks \<rivolaks@hot.ee\>
+
+@maintainers
+Lubos Lunak \<l.lunak@kde.org\>
+
+@licences
+libkdecorations: @bsd<br>
+libkwineffects: @gpl
+
 */
+
+// DOXYGEN_SET_PROJECT_NAME = KWin Libraries
+// vim:ts=4:sw=4:expandtab:filetype=doxygen