Index: /trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UIWindowMenuManager.cpp
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UIWindowMenuManager.cpp	(revision 57889)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UIWindowMenuManager.cpp	(revision 57890)
@@ -5,5 +5,5 @@
 
 /*
- * Copyright (C) 2010-2012 Oracle Corporation
+ * Copyright (C) 2010-2015 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -20,8 +20,8 @@
 #else  /* !VBOX_WITH_PRECOMPILED_HEADERS */
 
-/* Local includes */
+/* GUI includes: */
 # include "UIWindowMenuManager.h"
 
-/* Global includes */
+/* Qt includes: */
 # include <QApplication>
 # include <QMenu>
@@ -29,5 +29,6 @@
 #endif /* !VBOX_WITH_PRECOMPILED_HEADERS */
 
-
+/** QObject extension
+  * used as Mac OS X 'Window' menu helper. */
 class UIMenuHelper: public QObject
 {
@@ -35,4 +36,6 @@
 
 public:
+
+    /** Constructs menu-helper on the basis of passed @a winList. */
     UIMenuHelper(const QList<QWidget*> &winList)
     {
@@ -51,4 +54,6 @@
         retranslateUi();
     }
+
+    /** Destructs menu-helper. */
     ~UIMenuHelper()
     {
@@ -57,6 +62,8 @@
     }
 
+    /** Returns 'Window' menu. */
     QMenu *menu() const { return m_pWindowMenu; }
 
+    /** Adds window into 'Window' menu. */
     QAction* addWindow(QWidget *pWindow)
     {
@@ -84,4 +91,6 @@
         return pAction;
     }
+
+    /** Removes window from 'Window' menu. */
     void removeWindow(QWidget *pWindow)
     {
@@ -93,4 +102,5 @@
     }
 
+    /** Handles translation event. */
     void retranslateUi()
     {
@@ -100,4 +110,5 @@
     }
 
+    /** Updates toggle action states according to passed @a pActive. */
     void updateStatus(QWidget *pActive)
     {
@@ -118,4 +129,5 @@
 private slots:
 
+    /** Handles request to minimize active-window. */
     void minimizeActive(bool /* fToggle */)
     {
@@ -123,4 +135,6 @@
             pActive->showMinimized();
     }
+
+    /** Handles request to raise sender window. */
     void raiseSender(bool /* fToggle */)
     {
@@ -138,13 +152,18 @@
 private:
 
-    /* Private member vars */
+    /** Holds the 'Window' menu instance. */
     QMenu *m_pWindowMenu;
+    /** Holds the action group instance. */
     QActionGroup *m_pGroup;
+    /** Holds the 'Minimize' action instance. */
     QAction *m_pMinimizeAction;
+    /** Holds the hash of the registered menu-helper instances. */
     QHash<QString, QAction*> m_regWindows;
 };
 
+/* static */
 UIWindowMenuManager *UIWindowMenuManager::m_pInstance = 0;
 
+/* static */
 UIWindowMenuManager *UIWindowMenuManager::instance(QWidget *pParent /* = 0 */)
 {
@@ -155,4 +174,5 @@
 }
 
+/* static */
 void UIWindowMenuManager::destroy()
 {
Index: /trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UIWindowMenuManager.h
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UIWindowMenuManager.h	(revision 57889)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/platform/darwin/UIWindowMenuManager.h	(revision 57890)
@@ -5,5 +5,5 @@
 
 /*
- * Copyright (C) 2010 Oracle Corporation
+ * Copyright (C) 2010-2015 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -16,17 +16,17 @@
  */
 
-#ifndef __UIWindowMenuManager_h__
-#define __UIWindowMenuManager_h__
+#ifndef ___UIWindowMenuManager_h___
+#define ___UIWindowMenuManager_h___
 
-/* Global includes */
+/* Qt includes: */
 #include <QObject>
 #include <QHash>
 
-/* Local forward declarations */
+/* Forward declarations: */
 class UIMenuHelper;
-
-/* Global forward declarations */
 class QMenu;
 
+/** Singleton QObject extension
+  * used as Mac OS X 'Window' menu Manager. */
 class UIWindowMenuManager: public QObject
 {
@@ -35,31 +35,47 @@
 public:
 
+    /** Static constructor and instance provider. */
     static UIWindowMenuManager *instance(QWidget *pParent = 0);
+    /** Static destructor. */
     static void destroy();
 
+    /** Creates 'Window' menu for passed @a pWindow. */
     QMenu *createMenu(QWidget *pWindow);
+    /** Destroys 'Window' menu for passed @a pWindow. */
     void destroyMenu(QWidget *pWindow);
 
+    /** Adds @a pWindow to all 'Window' menus. */
     void addWindow(QWidget *pWindow);
+    /** Removes @a pWindow from all 'Window' menus. */
     void removeWindow(QWidget *pWindow);
 
+    /** Handles translation event. */
     void retranslateUi();
 
 protected:
 
+    /** Preprocesses any Qt @a pEvent for passed @a pObject. */
     bool eventFilter(QObject *pObj, QEvent *pEvent);
 
 private:
 
+    /** Constructs 'Window' menu Manager. */
     UIWindowMenuManager(QWidget *pParent = 0);
+    /** Destructs 'Window' menu Manager. */
     ~UIWindowMenuManager();
 
-    /* Private member vars */
+    /** Holds the static instance. */
     static UIWindowMenuManager *m_pInstance;
+
+    /** Holds the passed parent reference. */
     QWidget *m_pParent;
+
+    /** Holds the list of the registered window references. */
     QList<QWidget*> m_regWindows;
+
+    /** Holds the hash of the registered menu-helper instances. */
     QHash<QWidget*, UIMenuHelper*> m_helpers;
 };
 
-#endif /* __UIWindowMenuManager_h__ */
+#endif /* !___UIWindowMenuManager_h___ */