Index: /trunk/include/VBox/settings.h
===================================================================
--- /trunk/include/VBox/settings.h	(revision 75395)
+++ /trunk/include/VBox/settings.h	(revision 75396)
@@ -498,10 +498,18 @@
     bool operator==(const RecordingScreenSettings &d) const;
 
+    /** Whether to record this screen or not. */
     bool                   fEnabled;   // requires settings version 1.14 (VirtualBox 4.3)
-    RecordingDestination_T enmDest;    // new since VirtualBox 6.0.
-    RecordingFeatureMap    featureMap; // new since VirtualBox 6.0.
+    /** Destination to record to. */
+    RecordingDestination_T enmDest;    /** @todo Implement with next settings version bump. */
+    /** Which features are enable or not. */
+    RecordingFeatureMap    featureMap; /** @todo Implement with next settings version bump. */
+    /** Maximum time (in s) to record. If set to 0, no time limit is set. */
     uint32_t               ulMaxTimeS; // requires settings version 1.14 (VirtualBox 4.3)
+    /** Options string for hidden / advanced / experimental features. */
     com::Utf8Str           strOptions; // new since VirtualBox 5.2.
 
+    /**
+     * Structure holding settings for audio recording.
+     */
     struct Audio
     {
@@ -513,13 +521,16 @@
 
         /** The audio codec type to use. */
-        RecordingAudioCodec_T enmAudioCodec; // new since VirtualBox 6.0.
+        RecordingAudioCodec_T enmAudioCodec; /** @todo Implement with next settings version bump. */
         /** Hz rate. */
-        uint16_t              uHz;           // new since VirtualBox 6.0.
+        uint16_t              uHz;           /** @todo Implement with next settings version bump. */
         /** Bits per sample. */
-        uint8_t               cBits;         // new since VirtualBox 6.0.
+        uint8_t               cBits;         /** @todo Implement with next settings version bump. */
         /** Number of audio channels. */
-        uint8_t               cChannels;     // new since VirtualBox 6.0.
+        uint8_t               cChannels;     /** @todo Implement with next settings version bump. */
     } Audio;
 
+    /**
+     * Structure holding settings for video recording.
+     */
     struct Video
     {
@@ -531,11 +542,19 @@
             , ulFPS(25) { }
 
-        RecordingVideoCodec_T enmCodec;  // new since VirtualBox 6.0.
+        /** The codec to use. */
+        RecordingVideoCodec_T enmCodec;  /** @todo Implement with next settings version bump. */
+        /** Target frame width in pixels (X). */
         uint32_t              ulWidth;   // requires settings version 1.14 (VirtualBox 4.3)
+        /** Target frame height in pixels (Y). */
         uint32_t              ulHeight;  // requires settings version 1.14 (VirtualBox 4.3)
+        /** Encoding rate. */
         uint32_t              ulRate;    // requires settings version 1.14 (VirtualBox 4.3)
+        /** Frames per second (FPS). */
         uint32_t              ulFPS;     // requires settings version 1.14 (VirtualBox 4.3)
     } Video;
 
+    /**
+     * Structure holding settings if the destination is a file.
+     */
     struct File
     {
@@ -543,10 +562,14 @@
             : ulMaxSizeMB(0) { }
 
+        /** Maximum size (in MB) the file is allowed to have.
+         *  When reaching the limit, recording will stop. */
         uint32_t     ulMaxSizeMB; // requires settings version 1.14 (VirtualBox 4.3)
+        /** Absolute file name path to use for recording. */
         com::Utf8Str strName;     // requires settings version 1.14 (VirtualBox 4.3)
     } File;
 };
 
-/** Map for keeping settings per virtual screen. */
+/** Map for keeping settings per virtual screen.
+ *  The key specifies the screen ID. */
 typedef std::map<uint32_t, RecordingScreenSettings> RecordingScreenMap;
 
@@ -566,5 +589,8 @@
     bool operator==(const RecordingSettings &d) const;
 
+    /** Whether recording as a whole is enabled or disabled. */
     bool               fEnabled;       // requires settings version 1.14 (VirtualBox 4.3)
+    /** Map of handled recording screen settings.
+     *  The key specifies the screen ID. */
     RecordingScreenMap mapScreens;
 };
Index: /trunk/src/VBox/Main/xml/Settings.cpp
===================================================================
--- /trunk/src/VBox/Main/xml/Settings.cpp	(revision 75395)
+++ /trunk/src/VBox/Main/xml/Settings.cpp	(revision 75396)
@@ -2381,4 +2381,7 @@
 }
 
+/**
+ * Applies the default settings.
+ */
 void RecordingScreenSettings::applyDefaults(void)
 {
@@ -2404,5 +2407,5 @@
 
     featureMap[RecordingFeature_Video] = true;
-    featureMap[RecordingFeature_Audio] = false;
+    featureMap[RecordingFeature_Audio] = false; /** @todo Audio is not yet enabled by default. */
 }
 
@@ -2429,4 +2432,10 @@
 }
 
+/**
+ * Returns if a certain recording feature is enabled or not.
+ *
+ * @returns \c true if the feature is enabled, \c false if not.
+ * @param   enmFeature          Feature to check.
+ */
 bool RecordingScreenSettings::isFeatureEnabled(RecordingFeature_T enmFeature) const
 {