Changeset 42506 in vbox for trunk/doc/manual/en_US

Timestamp:

Aug 1, 2012 12:37:11 PM (12 years ago)

Author:

vboxsync

Message:

docs/manual: favor VBoxManage startvm --type headless somewhat over manual starting of VBoxHeadless, and document clearly that the former uses the VM settings for remote access unlike the latter

File:

• trunk/doc/manual/en_US/user_Frontends.xml (modified) (2 diffs)

trunk/doc/manual/en_US/user_Frontends.xml

@@ -186 +186 @@
           follows:<screen>VBoxHeadless --startvm &lt;uuid|name&gt;</screen></para>
 
-          <para>This way of starting the VM is preferred because you can see
-          more detailed error messages, especially for early failures before
-          the VM execution is started. If you have trouble with
-          <computeroutput>VBoxManage startvm</computeroutput>, it can help
-          greatly to start <computeroutput>VBoxHeadless</computeroutput>
-          directly to diagnose the problem cause.</para>
+          <para>This way of starting the VM helps troubleshooting problems
+          reported by <computeroutput>VBoxManage startvm ...</computeroutput>
+          because you can see sometimes more detailed error messages,
+          especially for early failures before the VM execution is started.
+          In normal situations <computeroutput>VBoxManage startvm</computeroutput>
+          is preferred since it runs the VM directly as a background process
+          which has to be done explicitly when directly starting
+          <computeroutput>VBoxHeadless</computeroutput>.</para>
         </listitem>
       </itemizedlist>
@@ -205 +207 @@
       have the VRDP server enabled depending on the VM configuration, as the
       other front-ends would, use this:<screen>VBoxHeadless --startvm &lt;uuid|name&gt; --vrde=config</screen></para>
+
+      <para>If you start the VM with <computeroutput>VBoxManage startvm ...</computerputput>
+      then the configuration settings of the VM are always used.</para>
     </sect2>