more api docu

2 files changed, 36 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
@@ -27,2 +27,23 @@
 
+
+/**
+ * \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)
@@ -34,4 +55,11 @@ QPEDialogListener::QPEDialogListener(QDialog *di ) : QObject(di)
 
+
+/**
+ * d'tor
+ */
 QPEDialogListener::~QPEDialogListener() {}
 
+/**
+ * \internal
+ */
 void QPEDialogListener::appMessage( const QCString &msg, const QByteArray & )
diff --git a/library/qpedialog.h b/library/qpedialog.h
index ed77720..1e35efd 100644
--- a/library/qpedialog.h
+++ b/library/qpedialog.h
@@ -26,2 +26,10 @@ class QPEDialogListenerData;
 
+/**
+ * \brief Listen on QCOP messages to accept/reject a dialog.
+ *
+ * If you want your dialog to be acceptables/rejectable by QCOP
+ * You need to create a QPEDialogListener with your Dialog as Argument.
+ * 
+ * This feature is at least use with the first use support of Opie
+ */
 class QPEDialogListener : public QObject