Index: /trunk/src/VBox/Main/idl/VirtualBox.xidl
===================================================================
--- /trunk/src/VBox/Main/idl/VirtualBox.xidl	(revision 61914)
+++ /trunk/src/VBox/Main/idl/VirtualBox.xidl	(revision 61915)
@@ -7783,5 +7783,5 @@
 
         If the given snapshot is an online snapshot, the machine will go to
-        the <link to="MachineState_Saved"> saved state</link>, so that the
+        the <link to="MachineState_Saved">saved state</link>, so that the
         next time it is powered on, the execution state will be restored
         from the state of the snapshot.
@@ -9354,5 +9354,5 @@
         Indicates whether VirtualBox was built with raw-mode support.
 
-        When this reads as False, the <link to="HWVirtExPropertyType::Enabled"/>
+        When this reads as False, the <link to="HWVirtExPropertyType_Enabled"/>
         setting will be ignored and assumed to be True.
       </desc>
@@ -11458,5 +11458,5 @@
       <param name="destination" type="wstring" dir="in">
         <desc>The path to the target directory (in the guest).  Unless the
-          <link to="DirectoryCopyFlags::CopyIntoExisting"/> flag is given, the
+          <link to="DirectoryCopyFlags_CopyIntoExisting"/> flag is given, the
           directory shall not already exist.  Guest path style.</desc>
       </param>
@@ -11483,5 +11483,5 @@
       <param name="destination" type="wstring" dir="in">
         <desc>Where to put the directory on the host.  Unless the
-          <link to="DirectoryCopyFlags::CopyIntoExisting"/> flag is given, the
+          <link to="DirectoryCopyFlags_CopyIntoExisting"/> flag is given, the
           directory shall not already exist.  Host path style.</desc>
       </param>
@@ -11508,5 +11508,5 @@
       <param name="destination" type="wstring" dir="in">
         <desc>Where to put the file in the guest. Unless the
-          <link to="DirectoryCopyFlags::CopyIntoExisting"/> flag is given, the
+          <link to="DirectoryCopyFlags_CopyIntoExisting"/> flag is given, the
           directory shall not already exist.  Guest style path.</desc>
       </param>
@@ -11687,5 +11687,5 @@
       <param name="flags" type="DirectoryRemoveRecFlag" dir="in" safearray="yes">
         <desc>Zero or more <link to="DirectoryRemoveRecFlag"/> flags.
-          <note>WARNING! SPECIFYING <link to="DirectoryRemoveRecFlag::ContentAndDir"/> IS
+          <note>WARNING! SPECIFYING <link to="DirectoryRemoveRecFlag_ContentAndDir"/> IS
              MANDATORY AT THE MOMENT!!</note>
         </desc>
@@ -11777,5 +11777,5 @@
 
         <note>Will overwrite the destination file unless
-          <link to="FileCopyFlag::NoReplace"/> is specified.</note>
+          <link to="FileCopyFlag_NoReplace"/> is specified.</note>
 
         <result name="E_NOTIMPL">
@@ -11803,5 +11803,5 @@
 
         <note>Will overwrite the destination file unless
-          <link to="FileCopyFlag::NoReplace"/> is specified.</note>
+          <link to="FileCopyFlag_NoReplace"/> is specified.</note>
 
         <result name="VBOX_E_IPRT_ERROR">
@@ -11830,5 +11830,5 @@
 
         <note>Will overwrite the destination file unless
-          <link to="FileCopyFlag::NoReplace"/> is specified.</note>
+          <link to="FileCopyFlag_NoReplace"/> is specified.</note>
 
         <result name="VBOX_E_IPRT_ERROR">
@@ -11994,5 +11994,5 @@
           ignore for all guest OSes.  It will in the future be implemented for
           Windows, OS/2 and maybe Solaris guests only, the others will ignore it.
-          Use <link to="FileSharingMode::All"/>.
+          Use <link to="FileSharingMode_All"/>.
         </desc>
       </param>
@@ -12778,6 +12778,6 @@
         The file current position always applies to the <link to="IFile::read"/>
         method, which updates it upon return.  Same goes for the <link to="IFile::write"/>
-        method except when <link to="IFile::accessMode"/> is <link to="FileAccessMode::AppendOnly"/>
-        or <link to="FileAccessMode::AppendRead"/>, where it will always write
+        method except when <link to="IFile::accessMode"/> is <link to="FileAccessMode_AppendOnly"/>
+        or <link to="FileAccessMode_AppendRead"/>, where it will always write
         to the end of the file and will leave this attribute unchanged.
 
@@ -12902,6 +12902,6 @@
         The file current position always applies to the <link to="IFile::read"/>
         method.  Same for the <link to="IFile::write"/> method it except when
-        the <link to="IFile::accessMode"/> is <link to="FileAccessMode::AppendOnly"/>
-        or <link to="FileAccessMode::AppendRead"/>.
+        the <link to="IFile::accessMode"/> is <link to="FileAccessMode_AppendOnly"/>
+        or <link to="FileAccessMode_AppendRead"/>.
       </desc>
       <param name="offset" type="long long" dir="in">
@@ -16886,7 +16886,19 @@
         </desc>
       </param>
-      <param name="width" type="unsigned long" dir="in"/>
-      <param name="height" type="unsigned long" dir="in"/>
-      <param name="bitsPerPixel" type="unsigned long" dir="in"/>
+      <param name="width" type="unsigned long" dir="in">
+        <desc>
+          The width of the guest screen.
+        </desc>
+      </param> 
+      <param name="height" type="unsigned long" dir="in">
+        <desc>
+          The height of the guest screen.
+        </desc>
+      </param> 
+      <param name="bitsPerPixel" type="unsigned long" dir="in">
+        <desc>
+          The number of bits per pixel of the guest screen.
+        </desc>
+      </param> 
     </method>