Index: /trunk/src/VBox/Main/idl/VirtualBox.xidl
===================================================================
--- /trunk/src/VBox/Main/idl/VirtualBox.xidl	(revision 31275)
+++ /trunk/src/VBox/Main/idl/VirtualBox.xidl	(revision 31276)
@@ -8530,13 +8530,16 @@
   >
     <desc>
-      The IMediumAttachment interface represents the attachment
-      of a storage medium to a virtual machine. Each machine contains
-      an array of its medium attachments in <link to="IMachine::mediumAttachments"/>.
-
-      Each medium attachment specifies a storage controller as well as a port
-      and device number. Fixed media (hard disks) will always also specify
-      an instance of IMedium in <link to="#medium" />, referring to the hard disk
-      medium. For removeable media, the IMedia instance is optional; it can be
-      @c null if no media is mounted (see <link to="IMachine::mountMedium" />).
+      The IMediumAttachment interface links storage media to virtual machines.
+      For each medium (<link to="IMedium"/>) which has been attached to a
+      storage controller (<link to="IStorageController"/>) of a machine
+      (<link to="IMachine"/>) via the <link to="IMachine::attachDevice" />
+      method, one instance of IMediumAttachment is added to the machine's
+      <link to="IMachine::mediumAttachments"/> array attribute.
+
+      Each medium attachment specifies the storage controller as well as a
+      port and device number and the IMedium instance representing a virtual
+      hard disk or floppy or DVD image. As a special exception, for removeable
+      media, the IMedium instance can be @c null to represent an empty drive
+      with no media inserted (see <link to="IMachine::mountMedium" />).
     </desc>