Description Tim Fletcher 2006-03-16 14:42:50 EST

In the "Workbench User Guide", "Tasks", "Running Eclipse" topic (http://help.eclipse.org/help31/index.jsp?topic=/org.eclipse.platform.doc.user/tasks/running_eclipse.htm) there is conflicting documentation for setting the VM to use.

The "Setting the Java VM using -vm" paragraph states:

"It is recommended that you explicitly specify which Java VM to use when running Eclipse. This is achieved with the -vm command line argument (for example, -vm c:\jre\bin\javaw.exe). If you don't use -vm, Eclipse will use the first Java VM found on the O/S path. When you install other products, they may change your path, resulting in a different Java VM being used when you next launch Eclipse."

In the very next paragraph "Advanced Topics in Running Eclipse" the "-vm VMPath" argument in the table is described to be:

"The location of Java Runtime Environment (JRE) to use to run the Eclipse platform. If not specified, the JRE is at jre, sibling of the Eclipse executable. Relative paths are interpreted relative to the directory that eclipse was started from."

The reader is left to wonder whether the JRE in the sibling directory to eclipse, jre, is used if the -vm arguement is ommitted or if the JRE is used selected by the first Java VM found in the O/S path as stated in the earlier section. Could Eclipse.org please clarify?