Index: /trunk/src/VBox/Frontends/VirtualBox/src/runtime/information/UIInformationDataItem.cpp
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/runtime/information/UIInformationDataItem.cpp	(revision 65284)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/runtime/information/UIInformationDataItem.cpp	(revision 65285)
@@ -60,4 +60,8 @@
 
 
+/*********************************************************************************************************************************
+*   Class UIInformationDataItem implementation.                                                                                  *
+*********************************************************************************************************************************/
+
 UIInformationDataItem::UIInformationDataItem(InformationElementType type, const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : m_type(type)
@@ -75,4 +79,6 @@
 {
     RT_NOREF(index);
+
+    /* For particular role: */
     switch (role)
     {
@@ -97,4 +103,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataGeneral implementation.                                                                               *
+*********************************************************************************************************************************/
+
 UIInformationDataGeneral::UIInformationDataGeneral(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_General, machine, console, pModel)
@@ -104,4 +115,5 @@
 QVariant UIInformationDataGeneral::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -129,4 +141,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataSystem implementation.                                                                                *
+*********************************************************************************************************************************/
+
 UIInformationDataSystem::UIInformationDataSystem(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_System, machine, console, pModel)
@@ -136,4 +153,5 @@
 QVariant UIInformationDataSystem::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -218,4 +236,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataDisplay implementation.                                                                               *
+*********************************************************************************************************************************/
+
 UIInformationDataDisplay::UIInformationDataDisplay(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_Display, machine, console, pModel)
@@ -225,4 +248,5 @@
 QVariant UIInformationDataDisplay::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -277,4 +301,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataStorage implementation.                                                                               *
+*********************************************************************************************************************************/
+
 UIInformationDataStorage::UIInformationDataStorage(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_Storage, machine, console, pModel)
@@ -284,4 +313,5 @@
 QVariant UIInformationDataStorage::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -341,4 +371,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataAudio implementation.                                                                                 *
+*********************************************************************************************************************************/
+
 UIInformationDataAudio::UIInformationDataAudio(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_Audio, machine, console, pModel)
@@ -348,4 +383,5 @@
 QVariant UIInformationDataAudio::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -379,4 +415,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataNetwork implementation.                                                                               *
+*********************************************************************************************************************************/
+
 UIInformationDataNetwork::UIInformationDataNetwork(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_Network, machine, console, pModel)
@@ -386,4 +427,5 @@
 QVariant UIInformationDataNetwork::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -444,4 +486,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataSerialPorts implementation.                                                                           *
+*********************************************************************************************************************************/
+
 UIInformationDataSerialPorts::UIInformationDataSerialPorts(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_Serial, machine, console, pModel)
@@ -451,4 +498,5 @@
 QVariant UIInformationDataSerialPorts::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -497,5 +545,10 @@
 }
 
+
 #ifdef VBOX_WITH_PARALLEL_PORTS
+/*********************************************************************************************************************************
+*   Class UIInformationDataParallelPorts implementation.                                                                         *
+*********************************************************************************************************************************/
+
 UIInformationDataParallelPorts::UIInformationDataParallelPorts(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_Parallel, machine, console, pModel)
@@ -505,4 +558,5 @@
 QVariant UIInformationDataParallelPorts::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -539,4 +593,9 @@
 #endif /* VBOX_WITH_PARALLEL_PORTS */
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataUSB implementation.                                                                                   *
+*********************************************************************************************************************************/
+
 UIInformationDataUSB::UIInformationDataUSB(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_USB, machine, console, pModel)
@@ -546,4 +605,5 @@
 QVariant UIInformationDataUSB::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -588,4 +648,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataSharedFolders implementation.                                                                         *
+*********************************************************************************************************************************/
+
 UIInformationDataSharedFolders::UIInformationDataSharedFolders(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_SharedFolders, machine, console, pModel)
@@ -596,4 +661,5 @@
 QVariant UIInformationDataSharedFolders::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -629,4 +695,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataRuntimeAttributes implementation.                                                                     *
+*********************************************************************************************************************************/
+
 UIInformationDataRuntimeAttributes::UIInformationDataRuntimeAttributes(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_RuntimeAttributes, machine, console, pModel)
@@ -636,4 +707,5 @@
 QVariant UIInformationDataRuntimeAttributes::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -771,4 +843,9 @@
 }
 
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataNetworkStatistics implementation.                                                                     *
+*********************************************************************************************************************************/
+
 UIInformationDataNetworkStatistics::UIInformationDataNetworkStatistics(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
     : UIInformationDataItem(InformationElementType_NetworkStatistics, machine, console, pModel)
@@ -822,4 +899,5 @@
 QVariant UIInformationDataNetworkStatistics::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
@@ -917,4 +995,9 @@
     m_pModel->updateData(index);
 }
+
+
+/*********************************************************************************************************************************
+*   Class UIInformationDataStorageStatistics implementation.                                                                     *
+*********************************************************************************************************************************/
 
 UIInformationDataStorageStatistics::UIInformationDataStorageStatistics(const CMachine &machine, const CConsole &console, UIInformationModel *pModel)
@@ -1013,4 +1096,5 @@
 QVariant UIInformationDataStorageStatistics::data(const QModelIndex &index, int role) const
 {
+    /* For particular role: */
     switch (role)
     {
Index: /trunk/src/VBox/Frontends/VirtualBox/src/runtime/information/UIInformationDataItem.h
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/runtime/information/UIInformationDataItem.h	(revision 65284)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/runtime/information/UIInformationDataItem.h	(revision 65285)
@@ -29,5 +29,4 @@
 
 /* COM includes: */
-/* COMEnums.h should be first header included for enum definitions: */
 #include "COMEnums.h"
 #include "CGuest.h"
@@ -46,4 +45,5 @@
 class UIInformationModel;
 
+
 /** QObject extension
   * used as data-item in information-model in session-information window. */
@@ -55,6 +55,7 @@
 
     /** Constructs information data-item of type @a type.
-      * @param machine is machine reference.
-      * @param console is machine console reference. */
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataItem(InformationElementType type, const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
@@ -65,5 +66,5 @@
     InformationElementType elementType() const { return m_type; }
 
-    /** Returns data for item specified by @a idx for the @a role. */
+    /** Returns data for item specified by @a index for the @a role. */
     virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
 
@@ -89,4 +90,5 @@
 };
 
+
 /** UIInformationDataItem extension for the details-element type 'General'. */
 class UIInformationDataGeneral : public UIInformationDataItem
@@ -96,11 +98,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set.
-      * @param fOpened brings whether the details-element should be visually opened. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataGeneral(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 /** UIInformationDataItem extension for the details-element type 'System'. */
@@ -111,11 +116,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set.
-      * @param fOpened brings whether the details-element should be visually opened. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataSystem(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 /** UIInformationDataItem extension for the details-element type 'System'. */
@@ -126,11 +134,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set.
-      * @param fOpened brings whether the details-element should be visually opened. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataDisplay(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 /** UIInformationDataItem extension for the details-element type 'Storage'. */
@@ -141,10 +152,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataStorage(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 /** UIInformationDataItem extension for the details-element type 'Audio'. */
@@ -155,10 +170,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataAudio(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 /** UIInformationDataItem extension for the details-element type 'Network'. */
@@ -169,10 +188,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataNetwork(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 /** UIInformationDataItem extension for the details-element type 'Serial ports'. */
@@ -183,10 +206,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataSerialPorts(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 #ifdef VBOX_WITH_PARALLEL_PORTS
@@ -198,11 +225,15 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataParallelPorts(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
+    /** Returns data for item specified by @a index for the @a role. */
     virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
 };
 #endif /* VBOX_WITH_PARALLEL_PORTS */
+
 
 /** UIInformationDataItem extension for the details-element type 'USB'. */
@@ -213,10 +244,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataUSB(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 /** UIInformationDataItem extension for the details-element type 'Shared folders'. */
@@ -227,13 +262,19 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataSharedFolders(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
+    /** Returns data for item specified by @a index for the @a role. */
     virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
 
 protected slots:
+
+    /** Updates item data. */
     void updateData();
 };
+
 
 /** UIInformationDataItem extension for the details-element type 'runtime attributes'. */
@@ -244,10 +285,14 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataRuntimeAttributes(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
-    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
-};
+    /** Returns data for item specified by @a index for the @a role. */
+    virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
+};
+
 
 /** UIInformationDataItem extension for the details-element type 'network statistics'. */
@@ -258,11 +303,15 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataNetworkStatistics(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
+    /** Returns data for item specified by @a index for the @a role. */
     virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
 
 private slots:
+
     /** Handles processing of statistics. */
     void sltProcessStatistics();
@@ -280,15 +329,16 @@
     struct CounterElementType { QString type; DataMapType list; };
 
-    /** VM statistics counter names. */
+    /** Holds the VM statistics counter names. */
     DataMapType        m_names;
-    /** VM statistics counter values. */
+    /** Holds the VM statistics counter values. */
     DataMapType        m_values;
-    /** VM statistics counter units. */
+    /** Holds the VM statistics counter units. */
     DataMapType        m_units;
-    /** VM statistics counter links. */
+    /** Holds the VM statistics counter links. */
     LinksMapType       m_links;
-    /** VM statistics update timer. */
+    /** Holds the VM statistics update timer instance. */
     QTimer            *m_pTimer;
 };
+
 
 /** UIInformationDataItem extension for the details-element type 'storage statistics'. */
@@ -299,11 +349,15 @@
 public:
 
-    /** Constructs details-element object for passed @a pParent set. */
+    /** Constructs details-element object.
+      * @param  machine  Brings the machine reference.
+      * @param  console  Brings the machine console reference.
+      * @param  pModel   Brings the information model this item belings to. */
     UIInformationDataStorageStatistics(const CMachine &machine, const CConsole &console, UIInformationModel *pModel);
 
-    /** Returns data for item specified by @a idx for the @a role. */
+    /** Returns data for item specified by @a index for the @a role. */
     virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const;
 
 private slots:
+
     /** Handles processing of statistics. */
     void sltProcessStatistics();
@@ -314,6 +368,5 @@
     QString parseStatistics(const QString &strText);
 
-    /** Converts a given storage controller type to the string representation used
-     * in statistics. */
+    /** Converts a given storage controller type to the string representation used in statistics. */
     const char *storCtrlType2Str(const KStorageControllerType enmCtrlType) const;
 
@@ -325,13 +378,13 @@
     struct CounterElementType { QString type; DataMapType list; };
 
-    /** VM statistics counter names. */
+    /** Holds the VM statistics counter names. */
     DataMapType        m_names;
-    /** VM statistics counter values. */
+    /** Holds the VM statistics counter values. */
     DataMapType        m_values;
-    /** VM statistics counter units. */
+    /** Holds the VM statistics counter units. */
     DataMapType        m_units;
-    /** VM statistics counter links. */
+    /** Holds the VM statistics counter links. */
     LinksMapType       m_links;
-    /** VM statistics update timer. */
+    /** Holds the VM statistics update timer instance. */
     QTimer            *m_pTimer;
 };
