# HG changeset patch
# User Doug Simon <doug.simon@oracle.com>
# Date 1329125258 -3600
# Node ID ccb5369481a28cbab15e11358e4d7ccee058e837
# Parent  ab4a47b6a187fc9852754fb0854e4ce73c785586
Clarified mx help text on how to build/run [Graal|Client|Server].

diff -r ab4a47b6a187 -r ccb5369481a2 mx/commands.py
--- a/mx/commands.py	Sun Feb 12 23:37:47 2012 +0100
+++ b/mx/commands.py	Mon Feb 13 10:27:38 2012 +0100
@@ -343,9 +343,12 @@
     return ret
     
 def build(args):
-    """builds the GraalVM binary and compiles the Graal classes
+    """build the VM binary
     
-    The optional last argument specifies what type of VM to build."""
+    The global '--vm' option selects which VM to build. This command also
+    compiles the Graal classes irrespective of what VM is being built.
+    The optional last argument specifies what build level is to be used
+    for the VM binary."""
     
     # Call mx.build to compile the Java sources        
     opts2 = mx.build(['--source', '1.7'] + args, parser=ArgumentParser(prog='mx build'))
@@ -430,7 +433,7 @@
                     f.write(line)
     
 def vm(args, vm=None, nonZeroIsFatal=True, out=None, err=None, cwd=None, timeout=None, vmbuild=None):
-    """run the GraalVM"""
+    """run the VM selected by the '--vm' option"""
 
     if vm is None:
         vm = _vm
@@ -686,7 +689,7 @@
     sanitycheck.getSPECjvm2008(benchArgs, skipValid, wt, it).bench('graal', opts=vmArgs)
     
 def hsdis(args):
-    """Installs the hsdis library
+    """install the hsdis library
 
     This is needed to support HotSpot's assembly dumping features.
     By default it installs the Intel syntax version, use the 'att' argument to install AT&T syntax."""
@@ -717,7 +720,7 @@
     }
 
     if (_vmSourcesAvailable):
-        mx.add_argument('--vm', action='store', dest='vm', default='graal', choices=['graal', 'server', 'client'], help='the VM to run (default: graal)')
+        mx.add_argument('--vm', action='store', dest='vm', default='graal', choices=['graal', 'server', 'client'], help='the VM to build/run (default: graal)')
         mx.add_argument('--product', action='store_const', dest='vmbuild', const='product', help='select the product build of the VM')
         mx.add_argument('--debug', action='store_const', dest='vmbuild', const='debug', help='select the debug build of the VM')
         mx.add_argument('--fastdebug', action='store_const', dest='vmbuild', const='fastdebug', help='select the fast debug build of the VM')