### Eclipse Workspace Patch 1.0 #P org.eclipse.equinox.app Index: META-INF/MANIFEST.MF =================================================================== RCS file: /cvsroot/rt/org.eclipse.equinox/compendium/bundles/org.eclipse.equinox.app/META-INF/MANIFEST.MF,v retrieving revision 1.21 diff -u -r1.21 MANIFEST.MF --- META-INF/MANIFEST.MF 21 Oct 2009 18:22:08 -0000 1.21 +++ META-INF/MANIFEST.MF 7 Jan 2010 16:15:23 -0000 @@ -2,7 +2,7 @@ Bundle-ManifestVersion: 2 Bundle-Name: %pluginName Bundle-SymbolicName: org.eclipse.equinox.app; singleton:=true -Bundle-Version: 1.2.100.qualifier +Bundle-Version: 1.3.0.qualifier Bundle-Vendor: %providerName Bundle-Activator: org.eclipse.equinox.internal.app.Activator Bundle-Localization: plugin Index: src/org/eclipse/equinox/app/IApplication.java =================================================================== RCS file: /cvsroot/rt/org.eclipse.equinox/compendium/bundles/org.eclipse.equinox.app/src/org/eclipse/equinox/app/IApplication.java,v retrieving revision 1.8 diff -u -r1.8 IApplication.java --- src/org/eclipse/equinox/app/IApplication.java 20 May 2009 20:00:21 -0000 1.8 +++ src/org/eclipse/equinox/app/IApplication.java 7 Jan 2010 16:15:23 -0000 @@ -37,7 +37,8 @@ /** * Exit object requesting that the command passed back be executed. Typically * this is used to relaunch Eclipse with different command line arguments. When the executable is - * relaunched the command line will be retrieved from the eclipse.exitdata system property. + * relaunched the command line will be retrieved from the + * {@link IApplicationContext#EXIT_DATA_PROPERTY eclipse.exitdata} system property. */ public static final Integer EXIT_RELAUNCH = new Integer(24); Index: src/org/eclipse/equinox/app/IApplicationContext.java =================================================================== RCS file: /cvsroot/rt/org.eclipse.equinox/compendium/bundles/org.eclipse.equinox.app/src/org/eclipse/equinox/app/IApplicationContext.java,v retrieving revision 1.10 diff -u -r1.10 IApplicationContext.java --- src/org/eclipse/equinox/app/IApplicationContext.java 17 Apr 2008 14:45:49 -0000 1.10 +++ src/org/eclipse/equinox/app/IApplicationContext.java 7 Jan 2010 16:15:23 -0000 @@ -25,6 +25,32 @@ * @noimplement This interface is not intended to be implemented by clients. */ public interface IApplicationContext { + + /** + * A system property that may be set by an application to specify exit data + * for the application. The value of the property must be a String. + *

+ * Typically applications do not need to set this property. If an error is detected + * while launching or running an application then the launcher will set this property + * automatically in order to display a message to the end user. An application may + * set this property for the following reasons: + *

+ *

+ * @since 1.3 + */ + // TODO need to document the format for providing error messages + // TODO may need to document the format for the command line to relaunch + public static final String EXIT_DATA_PROPERTY = "eclipse.exitdata"; //$NON-NLS-1$ + /** * A key used to store arguments for the application. The content of this argument * is unchecked and should conform to the expectations of the application being invoked.