Changeset 32310 in vbox

Timestamp:

Sep 8, 2010 11:41:40 AM (14 years ago)

Author:

vboxsync

Message:

Main/idl: enums are written as foo_bar not foo::bar

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (40 diffs)

trunk/src/VBox/Main/idl/VirtualBox.xidl

@@ -3827 +3827 @@
       <desc>
         Full path to the file that stores the execution state of
-        the machine when it is in the <link to="MachineState::Saved"/> state.
+        the machine when it is in the <link to="MachineState_Saved"/> state.
         <note>
           When the machine is not in the Saved state, this attribute is
@@ -4228 +4228 @@
 
         To indicate that no device is associated with the given position,
-        <link to="DeviceType::Null"/> should be used.
+        <link to="DeviceType_Null"/> should be used.
 
         @todo setHardDiskBootOrder(), setNetworkBootOrder()
@@ -4265 +4265 @@
 
         If here are no devices at the given position, then
-        <link to="DeviceType::Null"/> is returned.
+        <link to="DeviceType_Null"/> is returned.
 
         @todo getHardDiskBootOrder(), getNetworkBootOrder()
@@ -5975 +5975 @@
         powered on).
 
-        If the machine is in the <link to="MachineState::Saved"/> state,
+        If the machine is in the <link to="MachineState_Saved"/> state,
         it will continue its execution the point where the state has
         been saved.
@@ -5981 +5981 @@
         If the machine <link to="IMachine::teleporterEnabled"/> property is
         enabled on the machine being powered up, the machine will wait for an
-        incoming teleportation in the <link to="MachineState::TeleportingIn"/>
+        incoming teleportation in the <link to="MachineState_TeleportingIn"/>
         state. The returned progress object will have at least three
         operations where the last three are defined as: (1) powering up and
@@ -6009 +6009 @@
       <desc>
         Identical to powerUp except that the VM will enter the
-        <link to="MachineState::Paused"/> state, instead of
-        <link to="MachineState::Running"/>.
+        <link to="MachineState_Paused"/> state, instead of
+        <link to="MachineState_Running"/>.
 
         <see>#powerUp</see>
@@ -6236 +6236 @@
 
         The device needs to be in one of the following states:
-        <link to="USBDeviceState::Busy"/>,
-        <link to="USBDeviceState::Available"/> or
-        <link to="USBDeviceState::Held"/>,
+        <link to="USBDeviceState_Busy"/>,
+        <link to="USBDeviceState_Available"/> or
+        <link to="USBDeviceState_Held"/>,
         otherwise an error is immediately returned.
 
         When the device state is
-        <link to="USBDeviceState::Busy">Busy</link>, an error may also
+        <link to="USBDeviceState_Busy">Busy</link>, an error may also
         be returned if the host computer refuses to release it for some reason.
 
@@ -6488 +6488 @@
 
         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.
@@ -6497 +6497 @@
 
         <note>
-          If the machine state is <link to="MachineState::Saved">Saved</link>
+          If the machine state is <link to="MachineState_Saved">Saved</link>
           prior to this operation, the saved state file will be implicitly
           deleted (as if <link to="IConsole::discardSavedState"/> were
@@ -8260 +8260 @@
       Each snapshot contains the settings of the virtual machine (hardware
       configuration etc.). In addition, if the machine was running when the
-      snapshot was taken (<link to="IMachine::state"/> is <link to="MachineState::Running"/>),
+      snapshot was taken (<link to="IMachine::state"/> is <link to="MachineState_Running"/>),
       the current VM state is saved in the snapshot (similarly to what happens
       when a VM's state is saved). The snapshot is then said to
       be <i>online</i> because when restoring it, the VM will be running.
 
-      If the machine is saved (<link to="MachineState::Saved"/>), the snapshot
+      If the machine is saved (<link to="MachineState_Saved"/>), the snapshot
       receives a copy of the execution state file (<link to="IMachine::stateFilePath"/>).
 
-      Otherwise, if the machine was not running (<link to="MachineState::PoweredOff"/>
-      or <link to="MachineState::Aborted"/>), the snapshot is <i>offline</i>;
+      Otherwise, if the machine was not running (<link to="MachineState_PoweredOff"/>
+      or <link to="MachineState_Aborted"/>), the snapshot is <i>offline</i>;
       it then contains a so-called "zero execution state", representing a
       machine that is powered off.
@@ -8692 +8692 @@
       there is a possibility to cause VirtualBox to compose a unique value for
       the file name part of the location using the UUID of the hard disk. This
-      applies only to hard disks in <link to="MediumState::NotCreated"/> state,
+      applies only to hard disks in <link to="MediumState_NotCreated"/> state,
       e.g. before the storage unit is created, and works as follows. You set the
       value of the <link to="IMedium::location"/> attribute to a location
@@ -8892 +8892 @@
           For some storage types, reading this attribute may return an outdated
           (last known) value when <link to="#state"/> is <link
-          to="MediumState::Inaccessible"/> or <link
-          to="MediumState::LockedWrite"/> because the value of this attribute is
+          to="MediumState_Inaccessible"/> or <link
+          to="MediumState_LockedWrite"/> because the value of this attribute is
           stored within the storage unit itself. Also note that changing the
           attribute value is not possible in such case, as well as when the
-          medium is the <link to="MediumState::LockedRead"/> state.
+          medium is the <link to="MediumState_LockedRead"/> state.
         </note>
       </desc>
@@ -8981 +8981 @@
         <note>
           For media whose <link to="#state"/> is <link
-          to="MediumState::Inaccessible"/>, the value of this property is the
-          last known size. For <link to="MediumState::NotCreated"/> media,
+          to="MediumState_Inaccessible"/>, the value of this property is the
+          last known size. For <link to="MediumState_NotCreated"/> media,
           the returned value is zero.
         </note>
@@ -9030 +9030 @@
           </li>
           <li>As long as the medium has children, its type cannot be set
-              to <link to="MediumType::Writethrough"/>.
+              to <link to="MediumType_Writethrough"/>.
           </li>
           <li>The type of all differencing media is
-              <link to="MediumType::Normal"/> and cannot be changed.
+              <link to="MediumType_Normal"/> and cannot be changed.
           </li>
         </ul>
 
         The type of a newly created or opened medium is set to
-        <link to="MediumType::Normal"/>, except for DVD and floppy media,
-        which have a type of <link to="MediumType::Writethrough"/>.
+        <link to="MediumType_Normal"/>, except for DVD and floppy media,
+        which have a type of <link to="MediumType_Writethrough"/>.
       </desc>
     </attribute>
@@ -9090 +9090 @@
         medium for that. See the interface description for more information.
 
-        Note that all <link to="MediumType::Immutable">Immutable</link> media
+        Note that all <link to="MediumType_Immutable">Immutable</link> media
         are always read-only while all
-        <link to="MediumType::Writethrough">Writethrough</link> media are
+        <link to="MediumType_Writethrough">Writethrough</link> media are
         always not.
 
@@ -9117 +9117 @@
         <note>
           For media whose state is <link to="#state"/> is <link
-          to="MediumState::Inaccessible"/>, the value of this property is the
-          last known logical size. For <link to="MediumState::NotCreated"/>
+          to="MediumState_Inaccessible"/>, the value of this property is the
+          last known logical size. For <link to="MediumState_NotCreated"/>
           media, the returned value is zero.
         </note>
@@ -9602 +9602 @@
 
         Before the operation starts, the medium is placed in
-        <link to="MediumState::Creating"/> state. If the create operation
-        fails, the medium will be placed back in <link to="MediumState::NotCreated"/>
+        <link to="MediumState_Creating"/> state. If the create operation
+        fails, the medium will be placed back in <link to="MediumState_NotCreated"/>
         state.
 
         After the returned progress object reports that the operation has
         successfully completed, the medium state will be set to <link
-        to="MediumState::Created"/>, the medium will be remembered by this
+        to="MediumState_Created"/>, the medium will be remembered by this
         VirtualBox installation and may be attached to virtual machines.
 
@@ -9636 +9636 @@
         is already in progress, or if the medium is being in use (locked for
         read or for write) or inaccessible. Therefore, the only valid state for
-        this operation to succeed is <link to="MediumState::Created"/>.
+        this operation to succeed is <link to="MediumState_Created"/>.
 
         Before the operation starts, the medium is placed in
-        <link to="MediumState::Deleting"/> state and gets removed from the list
+        <link to="MediumState_Deleting"/> state and gets removed from the list
         of remembered hard disks (media registry). If the delete operation
         fails, the medium will be remembered again and placed back to
-        <link to="MediumState::Created"/> state.
+        <link to="MediumState_Created"/> state.
 
         After the returned progress object reports that the operation is
         complete, the medium state will be set to
-        <link to="MediumState::NotCreated"/> and you will be able to use one of
+        <link to="MediumState_NotCreated"/> and you will be able to use one of
         the storage creation methods to create it again.
 
@@ -9679 +9679 @@
         argument.
 
-        The target medium must be in <link to="MediumState::NotCreated"/>
+        The target medium must be in <link to="MediumState_NotCreated"/>
         state (i.e. must not have an existing storage unit). Upon successful
         completion, this operation will set the type of the target medium to
-        <link to="MediumType::Normal"/> and create a storage unit necessary to
+        <link to="MediumType_Normal"/> and create a storage unit necessary to
         represent the differencing medium data in the given format (according
         to the storage format of the target object).
@@ -9691 +9691 @@
 
         <note>
-          The medium will be set to <link to="MediumState::LockedRead"/>
+          The medium will be set to <link to="MediumState_LockedRead"/>
           state for the duration of this operation.
         </note>
@@ -9756 +9756 @@
           <li>
             Neither the source medium nor the target medium is an
-            <link to="MediumType::Immutable"/> medium.
+            <link to="MediumType_Immutable"/> medium.
           </li>
           <li>
@@ -9769 +9769 @@
           <li>
             None of the involved media are in
-            <link to="MediumState::LockedRead"/> or
-            <link to="MediumState::LockedWrite"/> state.
+            <link to="MediumState_LockedRead"/> or
+            <link to="MediumState_LockedWrite"/> state.
           </li>
         </ul>
@@ -9776 +9776 @@
         <note>
           This (source) medium and all intermediates will be placed to <link
-          to="MediumState::Deleting"/> state and the target medium will be
-          placed to <link to="MediumState::LockedWrite"/> state and for the
+          to="MediumState_Deleting"/> state and the target medium will be
+          placed to <link to="MediumState_LockedWrite"/> state and for the
           duration of this operation.
         </note>
@@ -9796 +9796 @@
         location defined by the @a target argument.
 
-        The target medium must be either in <link to="MediumState::NotCreated"/>
+        The target medium must be either in <link to="MediumState_NotCreated"/>
         state (i.e. must not have an existing storage unit) or in
-        <link to="MediumState::Created"/> state (i.e. created and not locked, and
+        <link to="MediumState_Created"/> state (i.e. created and not locked, and
         big enough to hold the data or else the copy will be partial). Upon
         successful completion, the cloned medium will contain exactly the
@@ -9818 +9818 @@
 
         <note>
-          This medium will be placed to <link to="MediumState::LockedRead"/>
+          This medium will be placed to <link to="MediumState_LockedRead"/>
           state for the duration of this operation.
         </note>
@@ -9848 +9848 @@
         substantial amount of additional disk space.
 
-        This medium will be placed to <link to="MediumState::LockedWrite"/>
+        This medium will be placed to <link to="MediumState_LockedWrite"/>
         state and all its parent media (if any) will be placed to
-        <link to="MediumState::LockedRead"/> state for the duration of this
+        <link to="MediumState_LockedRead"/> state for the duration of this
         operation.
 
@@ -9879 +9879 @@
         is usually much lower than using the clone operation.
 
-        This medium will be placed to <link to="MediumState::LockedWrite"/>
+        This medium will be placed to <link to="MediumState_LockedWrite"/>
         state for the duration of this operation.
 
@@ -9915 +9915 @@
         </result>
         <result name="VBOX_E_INVALID_OBJECT_STATE">
-          Medium is not in <link to="MediumState::Created"/> or
-          <link to="MediumState::Inaccessible"/> state.
+          Medium is not in <link to="MediumState_Created"/> or
+          <link to="MediumState_Inaccessible"/> state.
         </result>
       </desc>
@@ -10102 +10102 @@
 
         The returned arrays are filled in only if the
-        <link to="MediumFormatCapabilities::Properties"/> flag is set.
+        <link to="MediumFormatCapabilities_Properties"/> flag is set.
         All arguments must be non-@c null.
 
@@ -10430 +10430 @@
       <desc>
         Color depth, in bits per pixel. When <link to="#pixelFormat"/> is <link
-        to="FramebufferPixelFormat::FOURCC_RGB">FOURCC_RGB</link>, valid values
+        to="FramebufferPixelFormat_FOURCC_RGB">FOURCC_RGB</link>, valid values
         are: 8, 15, 16, 24 and 32.
       </desc>
@@ -10438 +10438 @@
       <desc>
         Scan line size, in bytes. When <link to="#pixelFormat"/> is <link
-        to="FramebufferPixelFormat::FOURCC_RGB">FOURCC_RGB</link>, the
+        to="FramebufferPixelFormat_FOURCC_RGB">FOURCC_RGB</link>, the
         size of the scan line must be aligned to 32 bits.
       </desc>
@@ -10449 +10449 @@
         <note>
           This attribute must never return <link
-          to="FramebufferPixelFormat::Opaque"/> -- the format of the buffer
+          to="FramebufferPixelFormat_Opaque"/> -- the format of the buffer
           <link to="#address"/> points to must be always known.
         </note>
@@ -10555 +10555 @@
         The @a pixelFormat parameter defines whether the direct mode is
         available or not. If @a pixelFormat is <link
-        to="FramebufferPixelFormat::Opaque"/> then direct access to the guest
+        to="FramebufferPixelFormat_Opaque"/> then direct access to the guest
         VRAM buffer is not available -- the @a VRAM, @a bitsPerPixel and
         @a bytesPerLine parameters must be ignored and the implementation must use
@@ -10596 +10596 @@
         value must always correlate with <link to="#pixelFormat"/>. Note that
         the <link to="#pixelFormat"/> attribute must never return <link
-        to="FramebufferPixelFormat::Opaque"/> regardless of the selected mode.
+        to="FramebufferPixelFormat_Opaque"/> regardless of the selected mode.
 
         <note>
@@ -10947 +10947 @@
       <param name="screenId" type="unsigned long" dir="in">
         <desc>
-          Monitor to take screenshot from.
+          Monitor to take the screenshot from.
         </desc>
       </param>
@@ -10980 +10980 @@
 
       </desc>
-      <param name="screenId" type="unsigned long" dir="in"/>
-      <param name="address" type="octet" mod="ptr" dir="in"/>
+      <param name="screenId" type="unsigned long" dir="in">
+        <desc>
+          Monitor to take the screenshot from.
+        </desc>
+      </param>
+      <param name="address" type="octet" mod="ptr" dir="in">
+        <desc>
+          Address to store the screenshot to
+        </desc>
+      </param>
       <param name="x" type="unsigned long" dir="in">
-        <desc>Relative to the screen top left corner.</desc>
+        <desc>
+          Relative to the screen top left corner.
+        </desc>
       </param>
       <param name="y" type="unsigned long" dir="in">
-        <desc>Relative to the screen top left corner.</desc>
-      </param>
-      <param name="width" type="unsigned long" dir="in"/>
-      <param name="height" type="unsigned long" dir="in"/>
+        <desc>
+          Relative to the screen top left corner.
+        </desc>
+      </param>
+      <param name="width" type="unsigned long" dir="in">
+        <desc>
+          Desired image width.
+        </desc>
+      </param>
+      <param name="height" type="unsigned long" dir="in">
+        <desc>
+          Desired image height.
+        </desc>
+      </param>
     </method>
 
@@ -11588 +11608 @@
         They are run against a list of all currently available USB
         devices (in states
-        <link to="USBDeviceState::Available"/>,
-        <link to="USBDeviceState::Busy"/>,
-        <link to="USBDeviceState::Held"/>) that were not previously
+        <link to="USBDeviceState_Available"/>,
+        <link to="USBDeviceState_Busy"/>,
+        <link to="USBDeviceState_Held"/>) that were not previously
         ignored by global filters.
 
@@ -12903 +12923 @@
         for a particular session using the <link to="IMachine::launchVMProcess" />
         or <link to="IMachine::lockMachine" /> calls. Otherwise the state of
-        the machine will be set to <link to="MachineState::Aborted" /> on the
+        the machine will be set to <link to="MachineState_Aborted" /> on the
         server, and changes made to the machine settings will be lost.
 
@@ -14069 +14089 @@
         <desc>
           Event types listener is interested in. One can use wildcards like -
-          <link to="VBoxEventType::Any"/> to specify wildcards, matching more
+          <link to="VBoxEventType_Any"/> to specify wildcards, matching more
           than one event.
         </desc>
@@ -14860 +14880 @@
       The @a scope argument defines one of three scopes:
       <link to="IVirtualBox::sharedFolders">global shared folders</link>
-      (<link to="Scope::Global">Global</link>),
+      (<link to="Scope_Global">Global</link>),
       <link to="IMachine::sharedFolders">permanent shared folders</link> of
-      the machine (<link to="Scope::Machine">Machine</link>) or <link
+      the machine (<link to="Scope_Machine">Machine</link>) or <link
       to="IConsole::sharedFolders">transient shared folders</link> of the
-      machine (<link to="Scope::Session">Session</link>). Interested callees
+      machine (<link to="Scope_Session">Session</link>). Interested callees
       should use query the corresponding collections to find out what has
       changed.