update javadoc

bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPlatform.java

diff --git a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPlatform.java b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPlatform.java
index 3851ff8..5217fe0 100644
--- a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPlatform.java
+++ b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPlatform.java
@@ -14,11 +14,11 @@
 import java.io.InputStream;

 import java.net.URL;

 import java.util.*;

-import java.util.Map;

-import java.util.ResourceBundle;

 import org.eclipse.core.runtime.jobs.IJobManager;

 import org.osgi.framework.Bundle;

 

+// TODO clarify the javadoc below.  Copy the signatures from Platform.

+// talk to jeem about the best way to do the triplication

 /**

  * The central class of the Eclipse Platform Runtime. This class cannot

  * be instantiated or subclassed by clients; all functionality is provided 

bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java

diff --git a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java
index 08b0215..2b17a1b 100644
--- a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java
+++ b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/IPluginDescriptor.java
@@ -297,7 +297,7 @@
 	 * necessary to perform a 'resolve' on this URL.
 	 * 
 	 * @since 2.0
-	 * @deprecated {@link org.osgi.framework.Bundle#getEntry() Bundle#getEntry()}
+	 * @deprecated {@link Platform#find(Bundle, IPath) Platform#find(Bundle, IPath)}
 	 */
 	public URL find(IPath path);
 	/**
@@ -345,6 +345,7 @@
 	 * necessary to perform a 'resolve' on this URL.
 	 * 
 	 * @since 2.0
+	 * @deprecated {@link Platform#find(Bundle, IPath, Map) Platform#find(Bundle, IPath, Map)}
 	 */
 	public URL find(IPath path, Map override);
 	/**

bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/Platform.java

diff --git a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/Platform.java b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/Platform.java
index 37a6546..58e0910 100644
--- a/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/Platform.java
+++ b/bundles/org.eclipse.core.runtime/src/org/eclipse/core/runtime/Platform.java
@@ -15,13 +15,12 @@
 import java.lang.reflect.Method;
 import java.net.URL;
 import java.util.*;
-import java.util.Map;
-import java.util.ResourceBundle;
 import org.eclipse.core.internal.runtime.FindSupport;
 import org.eclipse.core.internal.runtime.InternalPlatform;
 import org.eclipse.core.runtime.jobs.IJobManager;
 import org.osgi.framework.Bundle;
 
+// TODO clarify the javadoc below 
 /**
  * The central class of the Eclipse Platform Runtime. This class cannot
  * be instantiated or subclassed by clients; all functionality is provided 
@@ -47,6 +46,8 @@
 	 * of the Core Runtime (pseudo-) plug-in.
 	 */
 	public static final String PI_RUNTIME = "org.eclipse.core.runtime"; //$NON-NLS-1$
+	
+	// TODO was this API anywhere?  On Plugin?
 	public static final String PI_BOOT = "org.eclipse.core.boot"; //$NON-NLS-1$
 	/** 
 	 * The simple identifier constant (value "<code>applications</code>") of