Bug 314492 - Do the annual copyright/javadoc bashAFTER_JAVADOC_BASH_FOR_36RC3

7 files changed, 56 insertions, 52 deletions

diff --git a/bundles/org.eclipse.swt/Eclipse SWT Program/carbon/org/eclipse/swt/program/Program.java b/bundles/org.eclipse.swt/Eclipse SWT Program/carbon/org/eclipse/swt/program/Program.java
index 8e86a7e2c2..477401e4f2 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Program/carbon/org/eclipse/swt/program/Program.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Program/carbon/org/eclipse/swt/program/Program.java
@@ -321,12 +321,13 @@ public static boolean launch (String fileName) {
 /**
  * Launches the operating system executable associated with the file or
  * URL (http:// or https://).  If the file is an executable then the
- * executable is launched.  If a valid working directory is specified
- * it is used as working directory for the launched program.
+ * executable is launched. The program is launched with the specified
+ * working directory only when the <code>workingDir</code> exists and
+ * <code>fileName</code> is an executable.
  * Note that a <code>Display</code> must already exist to guarantee
  * that this method returns an appropriate result.
  *
- * @param fileName the file or program name or URL (http:// or https://)
+ * @param fileName the file name or program name or URL (http:// or https://)
  * @param workingDir the name of the working directory or null
  * @return <code>true</code> if the file is launched, otherwise <code>false</code>
  * 
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Program/cocoa/org/eclipse/swt/program/Program.java b/bundles/org.eclipse.swt/Eclipse SWT Program/cocoa/org/eclipse/swt/program/Program.java
index 7663476ee2..df4ee14df2 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Program/cocoa/org/eclipse/swt/program/Program.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Program/cocoa/org/eclipse/swt/program/Program.java
@@ -265,12 +265,13 @@ public static boolean launch (String fileName) {
 /**
  * Launches the operating system executable associated with the file or
  * URL (http:// or https://).  If the file is an executable then the
- * executable is launched.  If a valid working directory is specified
- * it is used as working directory for the launched program.
+ * executable is launched. The program is launched with the specified
+ * working directory only when the <code>workingDir</code> exists and
+ * <code>fileName</code> is an executable.
  * Note that a <code>Display</code> must already exist to guarantee
  * that this method returns an appropriate result.
  *
- * @param fileName the file or program name or URL (http:// or https://)
+ * @param fileName the file name or program name or URL (http:// or https://)
  * @param workingDir the name of the working directory or null
  * @return <code>true</code> if the file is launched, otherwise <code>false</code>
  * 
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Program/emulated/org/eclipse/swt/program/Program.java b/bundles/org.eclipse.swt/Eclipse SWT Program/emulated/org/eclipse/swt/program/Program.java
index ae9a27baac..77cf60cece 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Program/emulated/org/eclipse/swt/program/Program.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Program/emulated/org/eclipse/swt/program/Program.java
@@ -95,12 +95,13 @@ public static boolean launch (String fileName) {
 /**
  * Launches the operating system executable associated with the file or
  * URL (http:// or https://).  If the file is an executable then the
- * executable is launched.  If a valid working directory is specified
- * it is used as working directory for the launched program.
+ * executable is launched. The program is launched with the specified
+ * working directory only when the <code>workingDir</code> exists and
+ * <code>fileName</code> is an executable.
  * Note that a <code>Display</code> must already exist to guarantee
  * that this method returns an appropriate result.
  *
- * @param fileName the file or program name or URL (http:// or https://)
+ * @param fileName the file name or program name or URL (http:// or https://)
  * @param workingDir the name of the working directory or null
  * @return <code>true</code> if the file is launched, otherwise <code>false</code>
  * 
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Program/gtk/org/eclipse/swt/program/Program.java b/bundles/org.eclipse.swt/Eclipse SWT Program/gtk/org/eclipse/swt/program/Program.java
index 5fbec60dc1..6f78ce277c 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Program/gtk/org/eclipse/swt/program/Program.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Program/gtk/org/eclipse/swt/program/Program.java
@@ -1027,23 +1027,24 @@ public static boolean launch(String fileName) {
 }
 
 /**
-* Launches the operating system executable associated with the file or
-* URL (http:// or https://).  If the file is an executable then the
-* executable is launched.  If a valid working directory is specified 
-* it is used as the working directory for the launched program.
-* Note that a <code>Display</code> must already exist to guarantee
-* that this method returns an appropriate result.
-*
-* @param fileName the file or program name or URL (http:// or https://)
-* @param workingDir the name of the working directory or null
-* @return <code>true</code> if the file is launched, otherwise <code>false</code>
-* 
-* @exception IllegalArgumentException <ul>
-*    <li>ERROR_NULL_ARGUMENT when fileName is null</li>
-* </ul>
-* 
-* @since 3.6
-*/
+ * Launches the operating system executable associated with the file or
+ * URL (http:// or https://).  If the file is an executable then the
+ * executable is launched. The program is launched with the specified
+ * working directory only when the <code>workingDir</code> exists and
+ * <code>fileName</code> is an executable.
+ * Note that a <code>Display</code> must already exist to guarantee
+ * that this method returns an appropriate result.
+ *
+ * @param fileName the file name or program name or URL (http:// or https://)
+ * @param workingDir the name of the working directory or null
+ * @return <code>true</code> if the file is launched, otherwise <code>false</code>
+ * 
+ * @exception IllegalArgumentException <ul>
+ *    <li>ERROR_NULL_ARGUMENT when fileName is null</li>
+ * </ul>
+ * 
+ * @since 3.6
+ */
 public static boolean launch (String fileName, String workingDir) {
 	return launch(Display.getCurrent(), fileName, workingDir);
 }
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Program/motif/org/eclipse/swt/program/Program.java b/bundles/org.eclipse.swt/Eclipse SWT Program/motif/org/eclipse/swt/program/Program.java
index a13fe75f61..58a8d97e20 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Program/motif/org/eclipse/swt/program/Program.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Program/motif/org/eclipse/swt/program/Program.java
@@ -750,24 +750,24 @@ public static boolean launch(String fileName) {
 }
 
 /**
-* Launches the operating system executable associated with the file or
-* URL (http:// or https://).  If the file is an executable then the
-* executable is launched.  If a valid working directory is specified 
-* it is used as the working directory for the launched program.
-* Note that a <code>Display</code> must already exist to guarantee
-* that this method returns an appropriate result.
-*
-* @param fileName the file or program name or URL (http:// or https://)
-* @param workingDir the name of the working directory or null
-* @return <code>true</code> if the file is launched, otherwise <code>false</code>
-* 
-* @exception IllegalArgumentException <ul>
-*    <li>ERROR_NULL_ARGUMENT when fileName is null</li>
-*    <li>ERROR_INVALID_ARGUMENT when workingDir is not valid</li>
-* </ul>
-* 
-* @since 3.6
-*/
+ * Launches the operating system executable associated with the file or
+ * URL (http:// or https://).  If the file is an executable then the
+ * executable is launched. The program is launched with the specified
+ * working directory only when the <code>workingDir</code> exists and
+ * <code>fileName</code> is an executable.
+ * Note that a <code>Display</code> must already exist to guarantee
+ * that this method returns an appropriate result.
+ *
+ * @param fileName the file name or program name or URL (http:// or https://)
+ * @param workingDir the name of the working directory or null
+ * @return <code>true</code> if the file is launched, otherwise <code>false</code>
+ * 
+ * @exception IllegalArgumentException <ul>
+ *    <li>ERROR_NULL_ARGUMENT when fileName is null</li>
+ * </ul>
+ * 
+ * @since 3.6
+ */
 public static boolean launch (String fileName, String workingDir) {
 	return launch(Display.getCurrent(), fileName, workingDir);
 }
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Program/photon/org/eclipse/swt/program/Program.java b/bundles/org.eclipse.swt/Eclipse SWT Program/photon/org/eclipse/swt/program/Program.java
index 72f1eac66a..741fa4666f 100755
--- a/bundles/org.eclipse.swt/Eclipse SWT Program/photon/org/eclipse/swt/program/Program.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Program/photon/org/eclipse/swt/program/Program.java
@@ -178,18 +178,18 @@ public static boolean launch (String fileName) {
 /**
  * Launches the operating system executable associated with the file or
  * URL (http:// or https://).  If the file is an executable then the
- * executable is launched.  If a valid working directory is specified 
- * it is used as the working directory for the launched program.
+ * executable is launched. The program is launched with the specified
+ * working directory only when the <code>workingDir</code> exists and
+ * <code>fileName</code> is an executable.
  * Note that a <code>Display</code> must already exist to guarantee
  * that this method returns an appropriate result.
  *
- * @param fileName the file or program name or URL (http:// or https://)
+ * @param fileName the file name or program name or URL (http:// or https://)
  * @param workingDir the name of the working directory or null
  * @return <code>true</code> if the file is launched, otherwise <code>false</code>
  * 
  * @exception IllegalArgumentException <ul>
  *    <li>ERROR_NULL_ARGUMENT when fileName is null</li>
- *    <li>ERROR_INVALID_ARGUMENT when workingDir is not valid</li>
  * </ul>
  * 
  * @since 3.6
diff --git a/bundles/org.eclipse.swt/Eclipse SWT Program/wpf/org/eclipse/swt/program/Program.java b/bundles/org.eclipse.swt/Eclipse SWT Program/wpf/org/eclipse/swt/program/Program.java
index c0d0c106ed..c4993e7766 100644
--- a/bundles/org.eclipse.swt/Eclipse SWT Program/wpf/org/eclipse/swt/program/Program.java
+++ b/bundles/org.eclipse.swt/Eclipse SWT Program/wpf/org/eclipse/swt/program/Program.java
@@ -242,18 +242,18 @@ public static boolean launch (String fileName) {
 /**
  * Launches the operating system executable associated with the file or
  * URL (http:// or https://).  If the file is an executable then the
- * executable is launched.  If a valid working directory is specified 
- * it is used as the working directory for the launched program.
+ * executable is launched. The program is launched with the specified
+ * working directory only when the <code>workingDir</code> exists and
+ * <code>fileName</code> is an executable.
  * Note that a <code>Display</code> must already exist to guarantee
  * that this method returns an appropriate result.
  *
- * @param fileName the file or program name or URL (http:// or https://)
+ * @param fileName the file name or program name or URL (http:// or https://)
  * @param workingDir the name of the working directory or null
  * @return <code>true</code> if the file is launched, otherwise <code>false</code>
  * 
  * @exception IllegalArgumentException <ul>
  *    <li>ERROR_NULL_ARGUMENT when fileName is null</li>
- *    <li>ERROR_INVALID_ARGUMENT when workingDir is not valid</li>
  * </ul>
  * 
  * @since 3.6