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

Details
Type:
Bug
Submit Date:
2012-01-18
Status:
Closed
Updated Date:
2013-10-20
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 (b11)

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