United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: 7131038 [macosx] Document usage of -XstartOnFirstThread and -Xdock:*
7131038 : [macosx] Document usage of -XstartOnFirstThread and -Xdock:*

Details
Type:
Bug
Submit Date:
2012-01-18
Status:
Closed
Updated Date:
2012-04-25
Project Name:
JDK
Resolved Date:
2012-03-05
Component:
client-libs
OS:
generic
Sub-Component:
java.awt
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
8
Fixed Versions:
7u4

Related Reports
Relates:
Relates:

Sub Tasks

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



Hardware and Software, Engineered to Work Together