--- a/src/hbwidgets/devicedialogs/hbdevicemessageboxsymbian.cpp	Fri Sep 17 08:32:10 2010 +0300
+++ b/src/hbwidgets/devicedialogs/hbdevicemessageboxsymbian.cpp	Mon Oct 04 00:38:12 2010 +0300
@@ -735,7 +735,7 @@
 
 /*!
     \class MHbDeviceMessageBoxObserver
-    \brief Interface to observe CHbDeviceMessageBoxSymbian.
+    \brief MHbDeviceMessageBoxObserver is an observer interface for observing CHbDeviceMessageBoxSymbian.
 
     \sa CHbDeviceMessageBoxSymbian
 */
@@ -753,22 +753,28 @@
     \sa CHbDeviceMessageBoxSymbian::SetObserver()
 */
 
-// Constructor
+/*!
+    Constructs CHbDeviceMessageBoxSymbian.
+*/
 CHbDeviceMessageBoxSymbian::CHbDeviceMessageBoxSymbian()
 {
 }
 
-// Destructor
+/*!
+    Destructs CHbDeviceMessageBoxSymbian. The message box launched by ShowL()
+    is closed if observer is set. If there is no observer, it is
+    left executing and closes itself by timeout.
+*/
 EXPORT_C CHbDeviceMessageBoxSymbian::~CHbDeviceMessageBoxSymbian()
 {
     delete d;
 }
 
 /*!
-    Factory function. Returns pointer to a device message box.
+    Constructs a new CHbDeviceMessageBoxSymbian and returns a pointer it.
 
     \param aType Selects a template for the message box. None, information, question or warning.
-    \param aObserver Observer for message box close event
+    \param aObserver Observer for message box close event. 0 if no observer.
 */
 EXPORT_C CHbDeviceMessageBoxSymbian* CHbDeviceMessageBoxSymbian::NewL(TType aType,
     MHbDeviceMessageBoxObserver *aObserver)