Changeset 45286 in vbox for trunk/doc

Timestamp:

Apr 2, 2013 11:59:39 AM (12 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

84681

Message:

doc/manual: document more options to lock down the VM selector window

File:

• trunk/doc/manual/en_US/user_AdvancedTopics.xml (modified) (1 diff)

trunk/doc/manual/en_US/user_AdvancedTopics.xml

@@ -1933 +1933 @@
         </glosslist></para>
 
-        <para>To disable any GUI customization do <screen>VBoxManage setextradata global GUI/Customizations</screen></para>
+      <para>To disable any GUI customization do
+        <screen>VBoxManage setextradata global GUI/Customizations</screen></para>
+
+      <title>VM selector customization</title>
+      <para>The following per-machine VM extradata settings can be used to change the
+        behavior of the VM selector window in respect of certain VMs:</para>
+      <screen>VBoxManage setextradata VM_NAME SETTING true</screen>
+      <para>where <computeroutput>SETTING</computeroutput> can be:</para>
+      <glosslist>
+        <glossentry>
+          <glossterm><computeroutput>GUI/HideDetails</computeroutput></glossterm>
+          <glossdef>
+            <para>Don't show the VM configuration of a certain VM. The details
+              window will remain just empty if this VM is selected.</para>
+          </glossdef>
+        </glossentry>
+        <glossentry>
+         <glossterm><computeroutput>GUI/PreventReconfiguration</computeroutput></glossterm>
+          <glossdef>
+            <para>Don't allow the user to open the settings dialog for a certain VM.</para>
+          </glossdef>
+        </glossentry>
+        <glossentry>
+          <glossterm><computeroutput>GUI/HideFromManager</computeroutput></glossterm>
+          <glossdef>
+            <para>Hide a certain VM in the VM selector window.</para>
+          </glossdef>
+        </glossentry>
+      </glosslist>
+      <para>Please note that these settings wouldn't prevent the user from
+        reconfiguring the VM by <computeroutput>VBoxManage modifyvm</computeroutput>.</para>
+          
       </sect2>