more api docu

1 files changed, 28 insertions, 0 deletions

diff --git a/library/qpedialog.cpp b/library/qpedialog.cpp
index b98e42e..ac42972 100644
--- a/library/qpedialog.cpp
+++ b/library/qpedialog.cpp
@@ -20,25 +20,53 @@
 
 #define protected public
 #include <qdialog.h>
 #undef protected
 
 #include "qpedialog.h"
 #include <qpe/qpeapplication.h>
 
+
+/**
+ * \brief This is the only c'tor. 
+ * 
+ * The parent of this Listener is the Dialog you pass. This means once
+ * the dialog is deleted this listener will be deleted too.
+ * This Listener listens on QPEApplication::appMessage signal and implements
+ * accept() and reject().
+ *
+ * \code
+ *	QDialog *dialog = new YourDialog();
+	(void)new QPEDialogListener(dialog);
+	if( QPEApplication::execDialog(dialog) == QDialog::Accept ){
+	    // do some stuff
+	}
+	delete dialog;
+	
+ * \endcode
+ *
+ * @param di The dialog to handle
+ */
 QPEDialogListener::QPEDialogListener(QDialog *di ) : QObject(di)
 {
     dialog = di;
     connect(qApp, SIGNAL(appMessage(const QCString&, const QByteArray&)),
 	    this, SLOT(appMessage(const QCString&, const QByteArray&)) );
 }
 
+
+/**
+ * d'tor
+ */
 QPEDialogListener::~QPEDialogListener() {}
 
+/**
+ * \internal
+ */
 void QPEDialogListener::appMessage( const QCString &msg, const QByteArray & )
 {
     if (!dialog)
 	return;
     if (msg == "accept()") {
 	dialog->accept();
     } else if (msg == "reject()") {
 	dialog->reject();