'jruby -X' should be more friendly
----------------------------------
Key: JRUBY-4768
URL: http://jira.codehaus.org/browse/JRUBY-4768
Project: JRuby
Issue Type: Improvement
Components: Launcher
Affects Versions: JRuby 1.5.0.RC2, JRuby 1.6
Environment: Trunk, native launcher trunk
Reporter: Hiro Asari
Assignee: Vladimir Sizikov
Priority: Minor
With native launcher, {{jruby -Xhelp}} is not immediately obvious to get
extended help text. Instead, the existing {{jruby -X}} should print launcher's
extended help if applicable, while retaining the current behavior in the
absence of the launcher.
With launcher:
{noformat}
$ jruby -X
JRuby Launcher usage: jruby {options} arguments
To see general JRuby options, type 'jruby -h' or 'jruby --help'.
Options:
-Xversion print launcher's version
Jvm Management:
-Xjdkhome <path> set path to JDK
-Xfork-java run java in separate process
-J<jvm_option> pass <jvm_option> to JVM
Classpath Management:
-Xcp <classpath> set the classpath
-Xcp:p <classpath> prepend <classpath> to classpath
-Xcp:a <classpath> append <classpath> to classpath
-Xnobootclasspath don't put jruby jars on the bootclasspath
Misc:
-Xtrace <path> path for launcher log (for troubleshooting)
-Xcommand just print the equivalent java command and exit
Extended options:
-X-O run with ObjectSpace disabled (default; improves performance)
-X+O run with ObjectSpace enabled (reduces performance)
-X-C disable all compilation
-X+C force compilation of all scripts before they are run (except eval)
{noformat}
Without launcher:
{noformat}
$ jruby.sh -X
jruby: missing argument
Extended options:
-X-O run with ObjectSpace disabled (default; improves performance)
-X+O run with ObjectSpace enabled (reduces performance)
-X-C disable all compilation
-X+C force compilation of all scripts before they are run (except eval)
{noformat}
The attached patches should be pretty straightforward to provide this sort of
functionality. I also tweaked the text a little bit. Comments are welcome.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe from this list, please visit:
http://xircles.codehaus.org/manage_email
