JDK-7131038 : [macosx] Document usage of -XstartOnFirstThread and -Xdock:*
  • Type: Bug
  • Component: client-libs
  • Sub-Component: java.awt
  • Affected Version: 8
  • Priority: P4
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2012-01-18
  • Updated: 2017-05-17
  • Resolved: 2012-03-05
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availabitlity Release.

To download the current JDK release, click here.
JDK 7
7u4 b11Fixed
Related Reports
Relates :  
Description
The command-line arguments -XstartOnFirstThread, -Xdock:icon, and -Xdock:name should be documented appropriately as officially supported command line options on the Mac.

Comments
EVALUATION The issue is added to the Bug Fixes section of the Java SE 7u4 Update Release Notes
2012-04-25

EVALUATION 8-na: the fix is integrated as a part of 7113349.
2012-03-23

SUGGESTED FIX --- old/src/share/classes/sun/launcher/LauncherHelper.java 2012-01-20 16:21:59.000000000 +0400 +++ new/src/share/classes/sun/launcher/LauncherHelper.java 2012-01-20 16:21:58.000000000 +0400 @@ -381,6 +381,10 @@ PrintStream ostream = (printToStderr) ? System.err : System.out; ostream.println(getLocalizedMessage("java.launcher.X.usage", File.pathSeparator)); + if (System.getProperty("os.name").startsWith("Mac OS")) { + ostream.println(getLocalizedMessage("java.launcher.X.macosx.usage", + File.pathSeparator)); + } } static String getMainClassFromJar(PrintStream ostream, String jarname) { --- old/src/share/classes/sun/launcher/resources/launcher.properties 2012-01-20 16:22:00.000000000 +0400 +++ new/src/share/classes/sun/launcher/resources/launcher.properties 2012-01-20 16:21:59.000000000 +0400 @@ -109,6 +109,17 @@ \ show all locale related settings and continue\n\n\ The -X options are non-standard and subject to change without notice.\n +# Translators please note do not translate the options themselves +java.launcher.X.macosx.usage=\ +\n\ +The following options are Mac OS X specific:\n\ +\ -XstartOnFirstThread\n\ +\ run the main() method on the first (AppKit) thread\n\ +\ -Xdock:name=<application name>"\n\ +\ override default application name displayed in dock\n\ +\ -Xdock:icon=<path to icon file>\n\ +\ override default icon displayed in dock\n\n + java.launcher.cls.error1=\ Error: Could not find or load main class {0} java.launcher.cls.error2=\
2012-01-20

EVALUATION Need to update the -help output as well as file a CCC request.
2012-01-18