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

Need to update the -help output as well as file a CCC request.
                                     
2012-01-18
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

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

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



Hardware and Software, Engineered to Work Together