Index: /trunk/src/VBox/Frontends/VirtualBox/src/medium/UIMediumManager.cpp
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/medium/UIMediumManager.cpp	(revision 50703)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/medium/UIMediumManager.cpp	(revision 50704)
@@ -267,5 +267,5 @@
 void UIMediumManager::showModeless(QWidget *pCenterWidget /* = 0 */, bool fRefresh /* = true */)
 {
-    /* Prepare instance if not prepared: */
+    /* Create instance if not yet created: */
     if (!m_spInstance)
         m_spInstance = new UIMediumManager(pCenterWidget, fRefresh);
Index: /trunk/src/VBox/Frontends/VirtualBox/src/medium/UIMediumManager.h
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/medium/UIMediumManager.h	(revision 50703)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/medium/UIMediumManager.h	(revision 50704)
@@ -45,5 +45,5 @@
 };
 
-/* Medium Manager Dialog: */
+/** Medium Manager dialog. */
 class UIMediumManager : public QIWithRetranslateUI2<QIMainDialog>, public Ui::UIMediumManager
 {
@@ -56,12 +56,14 @@
     enum Action { Action_Add, Action_Edit, Action_Copy, Action_Modify, Action_Remove, Action_Release };
 
-    /* Constructor/destructor: */
+    /** Constructor for Medium Manager dialog. */
     UIMediumManager(QWidget *pCenterWidget, bool fRefresh = true);
+    /** Destructor for Medium Manager dialog. */
     ~UIMediumManager();
 
 public:
 
-    /* Static API: Singleton stuff: */
+    /** Returns Medium Manager singleton instance. */
     static UIMediumManager* instance();
+    /** Shows Medium Manager singleton instance, creates new if necessary. */
     static void showModeless(QWidget *pCenterWidget, bool fRefresh = true);
 
@@ -71,17 +73,23 @@
     void sltRefreshAll();
 
-    /* Handlers: Medium-processing stuff: */
+    /** Handles VBoxGlobal::sigMediumCreated signal. */
     void sltHandleMediumCreated(const QString &strMediumID);
+    /** Handles VBoxGlobal::sigMediumDeleted signal. */
     void sltHandleMediumDeleted(const QString &strMediumID);
 
-    /* Handlers: Medium-enumeration stuff: */
+    /** Handles VBoxGlobal::sigMediumEnumerationStarted signal. */
     void sltHandleMediumEnumerationStart();
+    /** Handles VBoxGlobal::sigMediumEnumerated signal. */
     void sltHandleMediumEnumerated(const QString &strMediumID);
+    /** Handles VBoxGlobal::sigMediumEnumerationFinished signal. */
     void sltHandleMediumEnumerationFinish();
 
-    /* Handlers: Medium-modification stuff: */
+    /** Calls for clone VD wizard to copy chosen medium. */
     void sltCopyMedium();
+    /** Calls for medium-type change dialog for chosen medium. */
     void sltModifyMedium();
+    /** Calls for remove medium dialog for chosen medium. */
     void sltRemoveMedium();
+    /** Calls for medium release dialog for chosen medium. */
     void sltReleaseMedium();