Committing the first phase of the phpDocBuilder.
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpdt / ui / JavaUI.java
index 9d306a6..4f37f42 100644 (file)
@@ -25,12 +25,13 @@ import org.eclipse.ui.internal.SharedImages;
 import org.eclipse.ui.texteditor.IDocumentProvider;
 
 /**
- * Central access point for the Java UI plug-in (id <code>"net.sourceforge.phpdt.ui"</code>).
- * This class provides static methods for:
+ * Central access point for the Java UI plug-in (id
+ * <code>"net.sourceforge.phpdt.ui"</code>). This class provides static
+ * methods for:
  * <ul>
- *  <li> creating various kinds of selection dialogs to present a collection
- *       of Java elements to the user and let them make a selection.</li>
- *  <li> opening a Java editor on a compilation unit.</li> 
+ * <li> creating various kinds of selection dialogs to present a collection of
+ * Java elements to the user and let them make a selection.</li>
+ * <li> opening a Java editor on a compilation unit.</li>
  * </ul>
  * <p>
  * This class provides static methods and fields only; it is not intended to be
@@ -38,515 +39,610 @@ import org.eclipse.ui.texteditor.IDocumentProvider;
  * </p>
  */
 public final class JavaUI {
-       
-       private static ISharedImages fgSharedImages= null;
-       
+
+       private static ISharedImages fgSharedImages = null;
+
        private JavaUI() {
                // prevent instantiation of JavaUI.
        }
-       
+
        /**
         * The id of the Java plugin (value <code>"net.sourceforge.phpdt.ui"</code>).
-        */     
-//     public static final String ID_PLUGIN= "net.sourceforge.phpdt.ui"; //$NON-NLS-1$
-       
-       /**
-        * The id of the Java perspective
-        * (value <code>"net.sourceforge.phpdt.ui.JavaPerspective"</code>).
-        */     
- //    public static final String ID_PERSPECTIVE=              "net.sourceforge.phpdt.ui.JavaPerspective"; //$NON-NLS-1$
-       
-       /**
-        * The id of the Java hierarchy perspective
-        * (value <code>"net.sourceforge.phpdt.ui.JavaHierarchyPerspective"</code>).
-        */     
-//     public static final String ID_HIERARCHYPERSPECTIVE= "net.sourceforge.phpdt.ui.JavaHierarchyPerspective"; //$NON-NLS-1$
-
+        */
+       // public static final String ID_PLUGIN= "net.sourceforge.phpdt.ui";
+       // //$NON-NLS-1$
        /**
-        * The id of the Java action set
-        * (value <code>"net.sourceforge.phpdt.ui.JavaActionSet"</code>).
+        * The id of the Java perspective (value
+        * <code>"net.sourceforge.phpdt.ui.JavaPerspective"</code>).
         */
-//     public static final String ID_ACTION_SET= "net.sourceforge.phpdt.ui.JavaActionSet"; //$NON-NLS-1$
-
+       // public static final String ID_PERSPECTIVE=
+       // "net.sourceforge.phpdt.ui.JavaPerspective"; //$NON-NLS-1$
+       /**
+        * The id of the Java hierarchy perspective (value
+        * <code>"net.sourceforge.phpdt.ui.JavaHierarchyPerspective"</code>).
+        */
+       // public static final String ID_HIERARCHYPERSPECTIVE=
+       // "net.sourceforge.phpdt.ui.JavaHierarchyPerspective"; //$NON-NLS-1$
        /**
-        * The id of the Java Element Creation action set
-        * (value <code>"net.sourceforge.phpdt.ui.JavaElementCreationActionSet"</code>).
+        * The id of the Java action set (value
+        * <code>"net.sourceforge.phpdt.ui.JavaActionSet"</code>).
+        */
+       // public static final String ID_ACTION_SET=
+       // "net.sourceforge.phpdt.ui.JavaActionSet"; //$NON-NLS-1$
+       /**
+        * The id of the Java Element Creation action set (value
+        * <code>"net.sourceforge.phpdt.ui.JavaElementCreationActionSet"</code>).
         * 
         * @since 2.0
         */
-//     public static final String ID_ELEMENT_CREATION_ACTION_SET= "net.sourceforge.phpdt.ui.JavaElementCreationActionSet"; //$NON-NLS-1$
-       
+       // public static final String ID_ELEMENT_CREATION_ACTION_SET=
+       // "net.sourceforge.phpdt.ui.JavaElementCreationActionSet"; //$NON-NLS-1$
        /**
-        * The id of the Java Coding action set
-        * (value <code>"net.sourceforge.phpdt.ui.CodingActionSet"</code>).
+        * The id of the Java Coding action set (value
+        * <code>"net.sourceforge.phpdt.ui.CodingActionSet"</code>).
         * 
         * @since 2.0
         */
-//     public static final String ID_CODING_ACTION_SET= "net.sourceforge.phpdt.ui.CodingActionSet"; //$NON-NLS-1$
-
+       // public static final String ID_CODING_ACTION_SET=
+       // "net.sourceforge.phpdt.ui.CodingActionSet"; //$NON-NLS-1$
        /**
-        * The id of the Java action set for open actions
-        * (value <code>"net.sourceforge.phpdt.ui.A_OpenActionSet"</code>).
+        * The id of the Java action set for open actions (value
+        * <code>"net.sourceforge.phpdt.ui.A_OpenActionSet"</code>).
         * 
         * @since 2.0
         */
-//     public static final String ID_OPEN_ACTION_SET= "net.sourceforge.phpdt.ui.A_OpenActionSet"; //$NON-NLS-1$
-
+       // public static final String ID_OPEN_ACTION_SET=
+       // "net.sourceforge.phpdt.ui.A_OpenActionSet"; //$NON-NLS-1$
        /**
-        * The id of the Java Search action set
-        * (value <code>net.sourceforge.phpdt.ui.SearchActionSet"</code>).
+        * The id of the Java Search action set (value
+        * <code>net.sourceforge.phpdt.ui.SearchActionSet"</code>).
         * 
         * @since 2.0
         */
-//     public static final String ID_SEARCH_ACTION_SET= "net.sourceforge.phpdt.ui.SearchActionSet"; //$NON-NLS-1$
-       
+       // public static final String ID_SEARCH_ACTION_SET=
+       // "net.sourceforge.phpdt.ui.SearchActionSet"; //$NON-NLS-1$
        /**
         * The editor part id of the editor that presents Java compilation units
         * (value <code>"net.sourceforge.phpdt.ui.CompilationUnitEditor"</code>).
-        */     
-//     public static final String ID_CU_EDITOR=                        "net.sourceforge.phpdt.ui.PHPUnitEditor"; //$NON-NLS-1$
-       
+        */
+       // public static final String ID_CU_EDITOR=
+       // "net.sourceforge.phpdt.ui.PHPUnitEditor"; //$NON-NLS-1$
        /**
         * The editor part id of the editor that presents Java binary class files
         * (value <code>"net.sourceforge.phpdt.ui.ClassFileEditor"</code>).
         */
-//     public static final String ID_CF_EDITOR=                        "net.sourceforge.phpdt.ui.ClassFileEditor"; //$NON-NLS-1$
-       
+       // public static final String ID_CF_EDITOR=
+       // "net.sourceforge.phpdt.ui.ClassFileEditor"; //$NON-NLS-1$
        /**
-        * The editor part id of the code snippet editor
-        * (value <code>"net.sourceforge.phpdt.ui.SnippetEditor"</code>).
+        * The editor part id of the code snippet editor (value
+        * <code>"net.sourceforge.phpdt.ui.SnippetEditor"</code>).
         */
-//     public static final String ID_SNIPPET_EDITOR=           "net.sourceforge.phpdt.ui.SnippetEditor"; //$NON-NLS-1$
-
+       // public static final String ID_SNIPPET_EDITOR=
+       // "net.sourceforge.phpdt.ui.SnippetEditor"; //$NON-NLS-1$
        /**
-        * The view part id of the Packages view
-        * (value <code>"net.sourceforge.phpdt.ui.PackageExplorer"</code>).
+        * The view part id of the Packages view (value
+        * <code>"net.sourceforge.phpdt.ui.PackageExplorer"</code>).
         * <p>
-        * When this id is used to access
-        * a view part with <code>IWorkbenchPage.findView</code> or 
-        * <code>showView</code>, the returned <code>IViewPart</code>
-        * can be safely cast to an <code>IPackagesViewPart</code>.
+        * When this id is used to access a view part with
+        * <code>IWorkbenchPage.findView</code> or <code>showView</code>, the
+        * returned <code>IViewPart</code> can be safely cast to an
+        * <code>IPackagesViewPart</code>.
         * </p>
-        *
+        * 
         * @see IPackagesViewPart
         * @see org.eclipse.ui.IWorkbenchPage#findView(java.lang.String)
         * @see org.eclipse.ui.IWorkbenchPage#showView(java.lang.String)
-        */ 
-       public static final String ID_PACKAGES= "net.sourceforge.phpdt.ui.PackageExplorer"; //$NON-NLS-1$
-       
-       /** 
-        * The view part id of the type hierarchy part.
-        * (value <code>"net.sourceforge.phpdt.ui.TypeHierarchy"</code>).
+        */
+       public static final String ID_PACKAGES = "net.sourceforge.phpdt.ui.PackageExplorer"; //$NON-NLS-1$
+
+       /**
+        * The view part id of the type hierarchy part. (value
+        * <code>"net.sourceforge.phpdt.ui.TypeHierarchy"</code>).
         * <p>
-        * When this id is used to access
-        * a view part with <code>IWorkbenchPage.findView</code> or 
-        * <code>showView</code>, the returned <code>IViewPart</code>
-        * can be safely cast to an <code>ITypeHierarchyViewPart</code>.
+        * When this id is used to access a view part with
+        * <code>IWorkbenchPage.findView</code> or <code>showView</code>, the
+        * returned <code>IViewPart</code> can be safely cast to an
+        * <code>ITypeHierarchyViewPart</code>.
         * </p>
-        *
+        * 
         * @see ITypeHierarchyViewPart
         * @see org.eclipse.ui.IWorkbenchPage#findView(java.lang.String)
         * @see org.eclipse.ui.IWorkbenchPage#showView(java.lang.String)
-        */ 
-       public static final String ID_TYPE_HIERARCHY=           "net.sourceforge.phpdt.ui.TypeHierarchy"; //$NON-NLS-1$
+        */
+       public static final String ID_TYPE_HIERARCHY = "net.sourceforge.phpdt.ui.TypeHierarchy"; //$NON-NLS-1$
 
        /**
-        * The id of the Java Browsing Perspective
-        * (value <code>"net.sourceforge.phpdt.ui.JavaBrowsingPerspective"</code>).
+        * The id of the Java Browsing Perspective (value
+        * <code>"net.sourceforge.phpdt.ui.JavaBrowsingPerspective"</code>).
         * 
         * @since 2.0
         */
-//     public static String ID_BROWSING_PERSPECTIVE= "net.sourceforge.phpdt.ui.JavaBrowsingPerspective"; //$NON-NLS-1$
-
+       // public static String ID_BROWSING_PERSPECTIVE=
+       // "net.sourceforge.phpdt.ui.JavaBrowsingPerspective"; //$NON-NLS-1$
        /**
-        * The view part id of the Java Browsing Projects view
-        * (value <code>"net.sourceforge.phpdt.ui.ProjectsView"</code>).
+        * The view part id of the Java Browsing Projects view (value
+        * <code>"net.sourceforge.phpdt.ui.ProjectsView"</code>).
         * 
         * @since 2.0
         */
-//     public static String ID_PROJECTS_VIEW= "net.sourceforge.phpdt.ui.ProjectsView"; //$NON-NLS-1$
-
+       // public static String ID_PROJECTS_VIEW=
+       // "net.sourceforge.phpdt.ui.ProjectsView"; //$NON-NLS-1$
        /**
-        * The view part id of the Java Browsing Packages view
-        * (value <code>"net.sourceforge.phpdt.ui.PackagesView"</code>).
+        * The view part id of the Java Browsing Packages view (value
+        * <code>"net.sourceforge.phpdt.ui.PackagesView"</code>).
         * 
         * @since 2.0
         */
-//     public static String ID_PACKAGES_VIEW= "net.sourceforge.phpdt.ui.PackagesView"; //$NON-NLS-1$
-
+       // public static String ID_PACKAGES_VIEW=
+       // "net.sourceforge.phpdt.ui.PackagesView"; //$NON-NLS-1$
        /**
-        * The view part id of the Java Browsing Types view
-        * (value <code>"net.sourceforge.phpdt.ui.TypesView"</code>).
+        * The view part id of the Java Browsing Types view (value
+        * <code>"net.sourceforge.phpdt.ui.TypesView"</code>).
         * 
         * @since 2.0
         */
-//     public static String ID_TYPES_VIEW= "net.sourceforge.phpdt.ui.TypesView"; //$NON-NLS-1$
-
+       // public static String ID_TYPES_VIEW= "net.sourceforge.phpdt.ui.TypesView";
+       // //$NON-NLS-1$
        /**
-        * The view part id of the Java Browsing Members view
-        * (value <code>"net.sourceforge.phpdt.ui.MembersView"</code>).
+        * The view part id of the Java Browsing Members view (value
+        * <code>"net.sourceforge.phpdt.ui.MembersView"</code>).
         * 
         * @since 2.0
         */
-//     public static String ID_MEMBERS_VIEW= "net.sourceforge.phpdt.ui.MembersView"; //$NON-NLS-1$
-
+       // public static String ID_MEMBERS_VIEW=
+       // "net.sourceforge.phpdt.ui.MembersView"; //$NON-NLS-1$
        /**
-        * The class org.eclipse.debug.core.model.IProcess allows attaching
-        * String properties to processes. The Java UI contributes a property
-        * page for IProcess that will show the contents of the property
-        * with this key.
-        * The intent of this property is to show the command line a process
-        * was launched with.
+        * The class org.eclipse.debug.core.model.IProcess allows attaching String
+        * properties to processes. The Java UI contributes a property page for
+        * IProcess that will show the contents of the property with this key. The
+        * intent of this property is to show the command line a process was
+        * launched with.
+        * 
         * @deprecated
         */
-//     public final static String ATTR_CMDLINE= "net.sourceforge.phpdt.ui.launcher.cmdLine"; //$NON-NLS-1$
-
+       // public final static String ATTR_CMDLINE=
+       // "net.sourceforge.phpdt.ui.launcher.cmdLine"; //$NON-NLS-1$
        /**
         * Returns the shared images for the Java UI.
-        *
+        * 
         * @return the shared images manager
         */
        public static ISharedImages getSharedImages() {
                if (fgSharedImages == null)
-                       fgSharedImages= new SharedImages();
-                       
+                       fgSharedImages = new SharedImages();
+
                return fgSharedImages;
        }
-        
-       /**
-        * Creates a selection dialog that lists all packages of the given Java project.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected package (of type
-        * <code>IPackageFragment</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param project the Java project
-        * @param style flags defining the style of the dialog; the valid flags are:
-        *   <code>IJavaElementSearchConstants.CONSIDER_BINARIES</code>, indicating that 
-        *   packages from binary package fragment roots should be included in addition
-        *   to those from source package fragment roots;
-        *   <code>IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS</code>, indicating that
-        *   packages from required projects should be included as well.
-        * @param filter the initial pattern to filter the set of packages. For example "com" shows 
-        * all packages starting with "com". The meta character '?' representing any character and 
-        * '*' representing any string are supported. Clients can pass an empty string if no filtering 
-        * is required.
+
+       /**
+        * Creates a selection dialog that lists all packages of the given Java
+        * project. The caller is responsible for opening the dialog with
+        * <code>Window.open</code>, and subsequently extracting the selected
+        * package (of type <code>IPackageFragment</code>) via
+        * <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param project
+        *            the Java project
+        * @param style
+        *            flags defining the style of the dialog; the valid flags are:
+        *            <code>IJavaElementSearchConstants.CONSIDER_BINARIES</code>,
+        *            indicating that packages from binary package fragment roots
+        *            should be included in addition to those from source package
+        *            fragment roots;
+        *            <code>IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS</code>,
+        *            indicating that packages from required projects should be
+        *            included as well.
+        * @param filter
+        *            the initial pattern to filter the set of packages. For example
+        *            "com" shows all packages starting with "com". The meta
+        *            character '?' representing any character and '*' representing
+        *            any string are supported. Clients can pass an empty string if
+        *            no filtering is required.
         * @return a new selection dialog
-        * @exception JavaModelException if the selection dialog could not be opened
+        * @exception JavaModelException
+        *                if the selection dialog could not be opened
         * 
         * @since 2.0
         */
-//     public static SelectionDialog createPackageDialog(Shell parent, IJavaProject project, int style, String filter) throws JavaModelException {
-//             Assert.isTrue((style | IJavaElementSearchConstants.CONSIDER_BINARIES | IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS) ==
-//                     (IJavaElementSearchConstants.CONSIDER_BINARIES | IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS));
-//
-//             IPackageFragmentRoot[] roots= null;
-//             if ((style & IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS) != 0) {
-//                 roots= project.getAllPackageFragmentRoots();
-//             } else {        
-//                     roots= project.getPackageFragmentRoots();       
-//             }
-//             
-//             List consideredRoots= null;
-//             if ((style & IJavaElementSearchConstants.CONSIDER_BINARIES) != 0) {
-//                     consideredRoots= Arrays.asList(roots);
-//             } else {
-//                     consideredRoots= new ArrayList(roots.length);
-//                     for (int i= 0; i < roots.length; i++) {
-//                             IPackageFragmentRoot root= roots[i];
-//                             if (root.getKind() != IPackageFragmentRoot.K_BINARY)
-//                                     consideredRoots.add(root);
-//                                     
-//                     }
-//             }
-//             
-//             int flags= JavaElementLabelProvider.SHOW_DEFAULT;
-//             if (consideredRoots.size() > 1)
-//                     flags= flags | JavaElementLabelProvider.SHOW_ROOT;
-//
-//             List packages= new ArrayList();
-//             Iterator iter= consideredRoots.iterator();
-//             while(iter.hasNext()) {
-//                     IPackageFragmentRoot root= (IPackageFragmentRoot)iter.next();
-//                     packages.addAll(Arrays.asList(root.getChildren()));
-//             }                       
-//             ElementListSelectionDialog dialog= new ElementListSelectionDialog(parent, new JavaElementLabelProvider(flags));
-//             dialog.setIgnoreCase(false);
-//             dialog.setElements(packages.toArray()); // XXX inefficient
-//             dialog.setFilter(filter);
-//             return dialog;
-//     }
-
-       /**
-        * Creates a selection dialog that lists all packages of the given Java project.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected package (of type
-        * <code>IPackageFragment</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param project the Java project
-        * @param style flags defining the style of the dialog; the valid flags are:
-        *   <code>IJavaElementSearchConstants.CONSIDER_BINARIES</code>, indicating that 
-        *   packages from binary package fragment roots should be included in addition
-        *   to those from source package fragment roots;
-        *   <code>IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS</code>, indicating that
-        *   packages from required projects should be included as well.
+       // public static SelectionDialog createPackageDialog(Shell parent,
+       // IJavaProject project, int style, String filter) throws JavaModelException
+       // {
+       // Assert.isTrue((style | IJavaElementSearchConstants.CONSIDER_BINARIES |
+       // IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS) ==
+       // (IJavaElementSearchConstants.CONSIDER_BINARIES |
+       // IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS));
+       //
+       // IPackageFragmentRoot[] roots= null;
+       // if ((style & IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS) !=
+       // 0) {
+       // roots= project.getAllPackageFragmentRoots();
+       // } else {
+       // roots= project.getPackageFragmentRoots();
+       // }
+       //              
+       // List consideredRoots= null;
+       // if ((style & IJavaElementSearchConstants.CONSIDER_BINARIES) != 0) {
+       // consideredRoots= Arrays.asList(roots);
+       // } else {
+       // consideredRoots= new ArrayList(roots.length);
+       // for (int i= 0; i < roots.length; i++) {
+       // IPackageFragmentRoot root= roots[i];
+       // if (root.getKind() != IPackageFragmentRoot.K_BINARY)
+       // consideredRoots.add(root);
+       //                                      
+       // }
+       // }
+       //              
+       // int flags= JavaElementLabelProvider.SHOW_DEFAULT;
+       // if (consideredRoots.size() > 1)
+       // flags= flags | JavaElementLabelProvider.SHOW_ROOT;
+       //
+       // List packages= new ArrayList();
+       // Iterator iter= consideredRoots.iterator();
+       // while(iter.hasNext()) {
+       // IPackageFragmentRoot root= (IPackageFragmentRoot)iter.next();
+       // packages.addAll(Arrays.asList(root.getChildren()));
+       // }
+       // ElementListSelectionDialog dialog= new ElementListSelectionDialog(parent,
+       // new JavaElementLabelProvider(flags));
+       // dialog.setIgnoreCase(false);
+       // dialog.setElements(packages.toArray()); // XXX inefficient
+       // dialog.setFilter(filter);
+       // return dialog;
+       // }
+       /**
+        * Creates a selection dialog that lists all packages of the given Java
+        * project. The caller is responsible for opening the dialog with
+        * <code>Window.open</code>, and subsequently extracting the selected
+        * package (of type <code>IPackageFragment</code>) via
+        * <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param project
+        *            the Java project
+        * @param style
+        *            flags defining the style of the dialog; the valid flags are:
+        *            <code>IJavaElementSearchConstants.CONSIDER_BINARIES</code>,
+        *            indicating that packages from binary package fragment roots
+        *            should be included in addition to those from source package
+        *            fragment roots;
+        *            <code>IJavaElementSearchConstants.CONSIDER_REQUIRED_PROJECTS</code>,
+        *            indicating that packages from required projects should be
+        *            included as well.
         * @return a new selection dialog
-        * @exception JavaModelException if the selection dialog could not be opened
-        */
-//     public static SelectionDialog createPackageDialog(Shell parent, IJavaProject project, int style) throws JavaModelException {
-//             return createPackageDialog(parent, project, style, ""); //$NON-NLS-1$
-//     }
-       
-       /**
-        * Creates a selection dialog that lists all packages under the given package 
-        * fragment root.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected package (of type
-        * <code>IPackageFragment</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param root the package fragment root
-        * @param filter the initial pattern to filter the set of packages. For example "com" shows 
-        * all packages starting with "com". The meta character '?' representing any character and 
-        * '*' representing any string are supported. Clients can pass an empty string if no filtering 
-        * is required.
+        * @exception JavaModelException
+        *                if the selection dialog could not be opened
+        */
+       // public static SelectionDialog createPackageDialog(Shell parent,
+       // IJavaProject project, int style) throws JavaModelException {
+       // return createPackageDialog(parent, project, style, ""); //$NON-NLS-1$
+       // }
+       /**
+        * Creates a selection dialog that lists all packages under the given
+        * package fragment root. The caller is responsible for opening the dialog
+        * with <code>Window.open</code>, and subsequently extracting the
+        * selected package (of type <code>IPackageFragment</code>) via
+        * <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param root
+        *            the package fragment root
+        * @param filter
+        *            the initial pattern to filter the set of packages. For example
+        *            "com" shows all packages starting with "com". The meta
+        *            character '?' representing any character and '*' representing
+        *            any string are supported. Clients can pass an empty string if
+        *            no filtering is required.
         * @return a new selection dialog
-        * @exception JavaModelException if the selection dialog could not be opened
+        * @exception JavaModelException
+        *                if the selection dialog could not be opened
         * 
         * @since 2.0
         */
-//     public static SelectionDialog createPackageDialog(Shell parent, IPackageFragmentRoot root, String filter) throws JavaModelException {
-//             ElementListSelectionDialog dialog= new ElementListSelectionDialog(parent, new JavaElementLabelProvider(JavaElementLabelProvider.SHOW_DEFAULT));
-//             dialog.setIgnoreCase(false);
-//             dialog.setElements(root.getChildren());
-//             dialog.setFilter(filter);
-//             return dialog;
-//     }
-
-       /**
-        * Creates a selection dialog that lists all packages under the given package 
-        * fragment root.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected package (of type
-        * <code>IPackageFragment</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param root the package fragment root
+       // public static SelectionDialog createPackageDialog(Shell parent,
+       // IPackageFragmentRoot root, String filter) throws JavaModelException {
+       // ElementListSelectionDialog dialog= new ElementListSelectionDialog(parent,
+       // new JavaElementLabelProvider(JavaElementLabelProvider.SHOW_DEFAULT));
+       // dialog.setIgnoreCase(false);
+       // dialog.setElements(root.getChildren());
+       // dialog.setFilter(filter);
+       // return dialog;
+       // }
+       /**
+        * Creates a selection dialog that lists all packages under the given
+        * package fragment root. The caller is responsible for opening the dialog
+        * with <code>Window.open</code>, and subsequently extracting the
+        * selected package (of type <code>IPackageFragment</code>) via
+        * <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param root
+        *            the package fragment root
         * @return a new selection dialog
-        * @exception JavaModelException if the selection dialog could not be opened
-        */
-//     public static SelectionDialog createPackageDialog(Shell parent, IPackageFragmentRoot root) throws JavaModelException {
-//             return createPackageDialog(parent, root, ""); //$NON-NLS-1$
-//     }
-
-       /**
-        * Creates a selection dialog that lists all types in the given scope.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected type(s) (of type
-        * <code>IType</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param context the runnable context used to show progress when the dialog
-        *   is being populated
-        * @param scope the scope that limits which types are included
-        * @param style flags defining the style of the dialog; the only valid values are
-        *   <code>IJavaElementSearchConstants.CONSIDER_CLASSES</code>,
-        *   <code>CONSIDER_INTERFACES</code>, or their bitwise OR 
-        *   (equivalent to <code>CONSIDER_TYPES</code>)
-        * @param multipleSelection <code>true</code> if multiple selection is allowed
-        * @param filter the initial pattern to filter the set of types. For example "Abstract" shows 
-        * all types starting with "abstract". The meta character '?' representing any character and 
-        * '*' representing any string are supported. Clients can pass an empty string if no filtering 
-        * is required.
-        * @exception JavaModelException if the selection dialog could not be opened
+        * @exception JavaModelException
+        *                if the selection dialog could not be opened
+        */
+       // public static SelectionDialog createPackageDialog(Shell parent,
+       // IPackageFragmentRoot root) throws JavaModelException {
+       // return createPackageDialog(parent, root, ""); //$NON-NLS-1$
+       // }
+       /**
+        * Creates a selection dialog that lists all types in the given scope. The
+        * caller is responsible for opening the dialog with
+        * <code>Window.open</code>, and subsequently extracting the selected
+        * type(s) (of type <code>IType</code>) via
+        * <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param context
+        *            the runnable context used to show progress when the dialog is
+        *            being populated
+        * @param scope
+        *            the scope that limits which types are included
+        * @param style
+        *            flags defining the style of the dialog; the only valid values
+        *            are <code>IJavaElementSearchConstants.CONSIDER_CLASSES</code>,
+        *            <code>CONSIDER_INTERFACES</code>, or their bitwise OR
+        *            (equivalent to <code>CONSIDER_TYPES</code>)
+        * @param multipleSelection
+        *            <code>true</code> if multiple selection is allowed
+        * @param filter
+        *            the initial pattern to filter the set of types. For example
+        *            "Abstract" shows all types starting with "abstract". The meta
+        *            character '?' representing any character and '*' representing
+        *            any string are supported. Clients can pass an empty string if
+        *            no filtering is required.
+        * @exception JavaModelException
+        *                if the selection dialog could not be opened
         * 
         * @since 2.0
         */
-//     public static SelectionDialog createTypeDialog(Shell parent, IRunnableContext context, IJavaSearchScope scope, int style, boolean multipleSelection, String filter) throws JavaModelException {
-//             int elementKinds= 0;
-//             if (style == IJavaElementSearchConstants.CONSIDER_TYPES) {
-//                     elementKinds= IJavaSearchConstants.TYPE;
-//             } else if (style == IJavaElementSearchConstants.CONSIDER_INTERFACES) {
-//                     elementKinds= IJavaSearchConstants.INTERFACE;
-//             } else if (style == IJavaElementSearchConstants.CONSIDER_CLASSES) {
-//                     elementKinds= IJavaSearchConstants.CLASS;
-//             } else {
-//                     Assert.isTrue(false, "illegal style"); //$NON-NLS-1$
-//             }
-//             if (multipleSelection) {
-//                     MultiTypeSelectionDialog dialog= new MultiTypeSelectionDialog(parent, context, elementKinds, scope);
-//                     dialog.setMessage(JavaUIMessages.getString("JavaUI.defaultDialogMessage")); //$NON-NLS-1$
-//                     dialog.setFilter(filter);
-//                     return dialog;                  
-//             } else {
-//                     TypeSelectionDialog dialog= new TypeSelectionDialog(parent, context, elementKinds, scope);
-//                     dialog.setMessage(JavaUIMessages.getString("JavaUI.defaultDialogMessage")); //$NON-NLS-1$
-//                     dialog.setFilter(filter);
-//                     return dialog;
-//             }
-//     }
-
-       /**
-        * Creates a selection dialog that lists all types in the given scope.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected type(s) (of type
-        * <code>IType</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param context the runnable context used to show progress when the dialog
-        *   is being populated
-        * @param scope the scope that limits which types are included
-        * @param style flags defining the style of the dialog; the only valid values are
-        *   <code>IJavaElementSearchConstants.CONSIDER_CLASSES</code>,
-        *   <code>CONSIDER_INTERFACES</code>, or their bitwise OR 
-        *   (equivalent to <code>CONSIDER_TYPES</code>)
-        * @param multipleSelection <code>true</code> if multiple selection is allowed
+       // public static SelectionDialog createTypeDialog(Shell parent,
+       // IRunnableContext context, IJavaSearchScope scope, int style, boolean
+       // multipleSelection, String filter) throws JavaModelException {
+       // int elementKinds= 0;
+       // if (style == IJavaElementSearchConstants.CONSIDER_TYPES) {
+       // elementKinds= IJavaSearchConstants.TYPE;
+       // } else if (style == IJavaElementSearchConstants.CONSIDER_INTERFACES) {
+       // elementKinds= IJavaSearchConstants.INTERFACE;
+       // } else if (style == IJavaElementSearchConstants.CONSIDER_CLASSES) {
+       // elementKinds= IJavaSearchConstants.CLASS;
+       // } else {
+       // Assert.isTrue(false, "illegal style"); //$NON-NLS-1$
+       // }
+       // if (multipleSelection) {
+       // MultiTypeSelectionDialog dialog= new MultiTypeSelectionDialog(parent,
+       // context, elementKinds, scope);
+       // dialog.setMessage(JavaUIMessages.getString("JavaUI.defaultDialogMessage"));
+       // //$NON-NLS-1$
+       // dialog.setFilter(filter);
+       // return dialog;
+       // } else {
+       // TypeSelectionDialog dialog= new TypeSelectionDialog(parent, context,
+       // elementKinds, scope);
+       // dialog.setMessage(JavaUIMessages.getString("JavaUI.defaultDialogMessage"));
+       // //$NON-NLS-1$
+       // dialog.setFilter(filter);
+       // return dialog;
+       // }
+       // }
+       /**
+        * Creates a selection dialog that lists all types in the given scope. The
+        * caller is responsible for opening the dialog with
+        * <code>Window.open</code>, and subsequently extracting the selected
+        * type(s) (of type <code>IType</code>) via
+        * <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param context
+        *            the runnable context used to show progress when the dialog is
+        *            being populated
+        * @param scope
+        *            the scope that limits which types are included
+        * @param style
+        *            flags defining the style of the dialog; the only valid values
+        *            are <code>IJavaElementSearchConstants.CONSIDER_CLASSES</code>,
+        *            <code>CONSIDER_INTERFACES</code>, or their bitwise OR
+        *            (equivalent to <code>CONSIDER_TYPES</code>)
+        * @param multipleSelection
+        *            <code>true</code> if multiple selection is allowed
         * @return a new selection dialog
-        * @exception JavaModelException if the selection dialog could not be opened
-        */
-//     public static SelectionDialog createTypeDialog(Shell parent, IRunnableContext context, IJavaSearchScope scope, int style, boolean multipleSelection) throws JavaModelException {
-//             return createTypeDialog(parent, context, scope, style, multipleSelection, "");//$NON-NLS-1$
-//     }
-               
-       /**
-        * Creates a selection dialog that lists all types in the given scope containing 
-        * a standard <code>main</code> method.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected type(s) (of type
-        * <code>IType</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param context the runnable context used to show progress when the dialog
-        *   is being populated
-        * @param scope the scope that limits which types are included
-        * @param style flags defining the style of the dialog; the only valid values are
-        *   <code>IJavaElementSearchConstants.CONSIDER_BINARIES</code>,
-        *   <code>CONSIDER_EXTERNAL_JARS</code>, or their bitwise OR, or <code>0</code>
-        * @param multipleSelection <code>true</code> if multiple selection is allowed
-        * @param filter the initial pattern to filter the set of types containg a main method. For 
-        * example "App" shows all types starting with "app". The meta character '?' representing 
-        * any character and '*' representing any string are supported. Clients can pass an empty 
-        * string if no filtering is required.
+        * @exception JavaModelException
+        *                if the selection dialog could not be opened
+        */
+       // public static SelectionDialog createTypeDialog(Shell parent,
+       // IRunnableContext context, IJavaSearchScope scope, int style, boolean
+       // multipleSelection) throws JavaModelException {
+       // return createTypeDialog(parent, context, scope, style, multipleSelection,
+       // "");//$NON-NLS-1$
+       // }
+       /**
+        * Creates a selection dialog that lists all types in the given scope
+        * containing a standard <code>main</code> method. The caller is
+        * responsible for opening the dialog with <code>Window.open</code>, and
+        * subsequently extracting the selected type(s) (of type <code>IType</code>)
+        * via <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param context
+        *            the runnable context used to show progress when the dialog is
+        *            being populated
+        * @param scope
+        *            the scope that limits which types are included
+        * @param style
+        *            flags defining the style of the dialog; the only valid values
+        *            are <code>IJavaElementSearchConstants.CONSIDER_BINARIES</code>,
+        *            <code>CONSIDER_EXTERNAL_JARS</code>, or their bitwise OR,
+        *            or <code>0</code>
+        * @param multipleSelection
+        *            <code>true</code> if multiple selection is allowed
+        * @param filter
+        *            the initial pattern to filter the set of types containg a main
+        *            method. For example "App" shows all types starting with "app".
+        *            The meta character '?' representing any character and '*'
+        *            representing any string are supported. Clients can pass an
+        *            empty string if no filtering is required.
         * @return a new selection dialog
         * 
         * @since 2.0
         */
-//     public static SelectionDialog createMainTypeDialog(Shell parent, IRunnableContext context, IJavaSearchScope scope, int style, boolean multipleSelection, String filter) {
-//             if (multipleSelection) {
-//                     MultiMainTypeSelectionDialog dialog= new MultiMainTypeSelectionDialog(parent, context, scope, style);
-//                     dialog.setFilter(filter);
-//                     return dialog;
-//             } else {
-//                     MainTypeSelectionDialog dialog= new MainTypeSelectionDialog(parent, context, scope, style);
-//                     dialog.setFilter(filter);
-//                     return dialog;
-//             }               
-//     }
-
-       /**
-        * Creates a selection dialog that lists all types in the given scope containing 
-        * a standard <code>main</code> method.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected type(s) (of type
-        * <code>IType</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param context the runnable context used to show progress when the dialog
-        *   is being populated
-        * @param scope the scope that limits which types are included
-        * @param style flags defining the style of the dialog; the only valid values are
-        *   <code>IJavaElementSearchConstants.CONSIDER_BINARIES</code>,
-        *   <code>CONSIDER_EXTERNAL_JARS</code>, or their bitwise OR, or <code>0</code>
-        * @param multipleSelection <code>true</code> if multiple selection is allowed
+       // public static SelectionDialog createMainTypeDialog(Shell parent,
+       // IRunnableContext context, IJavaSearchScope scope, int style, boolean
+       // multipleSelection, String filter) {
+       // if (multipleSelection) {
+       // MultiMainTypeSelectionDialog dialog= new
+       // MultiMainTypeSelectionDialog(parent, context, scope, style);
+       // dialog.setFilter(filter);
+       // return dialog;
+       // } else {
+       // MainTypeSelectionDialog dialog= new MainTypeSelectionDialog(parent,
+       // context, scope, style);
+       // dialog.setFilter(filter);
+       // return dialog;
+       // }
+       // }
+       /**
+        * Creates a selection dialog that lists all types in the given scope
+        * containing a standard <code>main</code> method. The caller is
+        * responsible for opening the dialog with <code>Window.open</code>, and
+        * subsequently extracting the selected type(s) (of type <code>IType</code>)
+        * via <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param context
+        *            the runnable context used to show progress when the dialog is
+        *            being populated
+        * @param scope
+        *            the scope that limits which types are included
+        * @param style
+        *            flags defining the style of the dialog; the only valid values
+        *            are <code>IJavaElementSearchConstants.CONSIDER_BINARIES</code>,
+        *            <code>CONSIDER_EXTERNAL_JARS</code>, or their bitwise OR,
+        *            or <code>0</code>
+        * @param multipleSelection
+        *            <code>true</code> if multiple selection is allowed
         * @return a new selection dialog
         */
-//     public static SelectionDialog createMainTypeDialog(Shell parent, IRunnableContext context, IJavaSearchScope scope, int style, boolean multipleSelection) {
-//             return createMainTypeDialog(parent, context, scope, style, multipleSelection, "");//$NON-NLS-1$
-//     }
-       
-       /**
-        * Creates a selection dialog that lists all types in the given project.
-        * The caller is responsible for opening the dialog with <code>Window.open</code>,
-        * and subsequently extracting the selected type(s) (of type
-        * <code>IType</code>) via <code>SelectionDialog.getResult</code>.
-        * 
-        * @param parent the parent shell of the dialog to be created
-        * @param context the runnable context used to show progress when the dialog
-        *   is being populated
-        * @param project the Java project
-        * @param style flags defining the style of the dialog; the only valid values are
-        *   <code>IJavaElementSearchConstants.CONSIDER_CLASSES</code>,
-        *   <code>CONSIDER_INTERFACES</code>, or their bitwise OR 
-        *   (equivalent to <code>CONSIDER_TYPES</code>)
-        * @param multipleSelection <code>true</code> if multiple selection is allowed
+       // public static SelectionDialog createMainTypeDialog(Shell parent,
+       // IRunnableContext context, IJavaSearchScope scope, int style, boolean
+       // multipleSelection) {
+       // return createMainTypeDialog(parent, context, scope, style,
+       // multipleSelection, "");//$NON-NLS-1$
+       // }
+       /**
+        * Creates a selection dialog that lists all types in the given project. The
+        * caller is responsible for opening the dialog with
+        * <code>Window.open</code>, and subsequently extracting the selected
+        * type(s) (of type <code>IType</code>) via
+        * <code>SelectionDialog.getResult</code>.
+        * 
+        * @param parent
+        *            the parent shell of the dialog to be created
+        * @param context
+        *            the runnable context used to show progress when the dialog is
+        *            being populated
+        * @param project
+        *            the Java project
+        * @param style
+        *            flags defining the style of the dialog; the only valid values
+        *            are <code>IJavaElementSearchConstants.CONSIDER_CLASSES</code>,
+        *            <code>CONSIDER_INTERFACES</code>, or their bitwise OR
+        *            (equivalent to <code>CONSIDER_TYPES</code>)
+        * @param multipleSelection
+        *            <code>true</code> if multiple selection is allowed
         * @return a new selection dialog
-        * @exception JavaModelException if the selection dialog could not be opened
-        */
-//     public static SelectionDialog createTypeDialog(Shell parent, IRunnableContext context, IProject project, int style, boolean multipleSelection) throws JavaModelException {
-//             IJavaSearchScope scope= SearchEngine.createJavaSearchScope(new IJavaProject[] { JavaCore.create(project) });
-//             return createTypeDialog(parent, context, scope, style, multipleSelection);
-//     }
-       
-       /**
-        * Opens a Java editor on the given Java element. The element can be a compilation unit 
-        * or class file. If there already is an open Java editor for the given element, it is returned.
-        *
-        * @param element the input element; either a compilation unit 
-        *   (<code>ICompilationUnit</code>) or a class file (</code>IClassFile</code>)
-        * @return the editor, or </code>null</code> if wrong element type or opening failed
-        * @exception PartInitException if the editor could not be initialized
-        * @exception JavaModelException if this element does not exist or if an
-        *              exception occurs while accessing its underlying resource
-        */
-       public static IEditorPart openInEditor(IJavaElement element) throws JavaModelException, PartInitException {
+        * @exception JavaModelException
+        *                if the selection dialog could not be opened
+        */
+       // public static SelectionDialog createTypeDialog(Shell parent,
+       // IRunnableContext context, IProject project, int style, boolean
+       // multipleSelection) throws JavaModelException {
+       // IJavaSearchScope scope= SearchEngine.createJavaSearchScope(new
+       // IJavaProject[] { JavaCore.create(project) });
+       // return createTypeDialog(parent, context, scope, style,
+       // multipleSelection);
+       // }
+       /**
+        * Opens a Java editor on the given Java element. The element can be a
+        * compilation unit or class file. If there already is an open Java editor
+        * for the given element, it is returned.
+        * 
+        * @param element
+        *            the input element; either a compilation unit (<code>ICompilationUnit</code>)
+        *            or a class file (</code>IClassFile</code>)
+        * @return the editor, or </code>null</code> if wrong element type or
+        *         opening failed
+        * @exception PartInitException
+        *                if the editor could not be initialized
+        * @exception JavaModelException
+        *                if this element does not exist or if an exception occurs
+        *                while accessing its underlying resource
+        */
+       public static IEditorPart openInEditor(IJavaElement element)
+                       throws JavaModelException, PartInitException {
                return EditorUtility.openInEditor(element);
        }
 
-       /** 
+       /**
         * Reveals the source range of the given source reference element in the
-        * given editor. No checking is done if the editor displays a compilation unit or
-        * class file that contains the given source reference. The editor simply reveals
-        * the source range denoted by the given source reference.
-        *
-        * @param part the editor displaying the compilation unit or class file
-        * @param element the source reference element defining the source range to be revealed
-        * 
-        * @deprecated use <code>revealInEditor(IEditorPart, IJavaElement)</code> instead
-        */     
-//     public static void revealInEditor(IEditorPart part, ISourceReference element) {
-//             if (element instanceof IJavaElement)
-//                     revealInEditor(part, (IJavaElement) element);
-//     }
-       
-       /** 
-        * Reveals the given java element  in the given editor. If the element is not an instance
-        * of <code>ISourceReference</code> this method result in a NOP. If it is a source
-        * reference no checking is done if the editor displays a compilation unit or class file that 
-        * contains the source reference element. The editor simply reveals the source range 
-        * denoted by the given element.
-        * 
-        * @param part the editor displaying a compilation unit or class file
-        * @param element the element to be revealed
+        * given editor. No checking is done if the editor displays a compilation
+        * unit or class file that contains the given source reference. The editor
+        * simply reveals the source range denoted by the given source reference.
+        * 
+        * @param part
+        *            the editor displaying the compilation unit or class file
+        * @param element
+        *            the source reference element defining the source range to be
+        *            revealed
+        * 
+        * @deprecated use <code>revealInEditor(IEditorPart, IJavaElement)</code>
+        *             instead
+        */
+       // public static void revealInEditor(IEditorPart part, ISourceReference
+       // element) {
+       // if (element instanceof IJavaElement)
+       // revealInEditor(part, (IJavaElement) element);
+       // }
+       /**
+        * Reveals the given java element in the given editor. If the element is not
+        * an instance of <code>ISourceReference</code> this method result in a
+        * NOP. If it is a source reference no checking is done if the editor
+        * displays a compilation unit or class file that contains the source
+        * reference element. The editor simply reveals the source range denoted by
+        * the given element.
+        * 
+        * @param part
+        *            the editor displaying a compilation unit or class file
+        * @param element
+        *            the element to be revealed
         * 
         * @since 2.0
         */
-//     public static void revealInEditor(IEditorPart part, IJavaElement element) {
-//             EditorUtility.revealInEditor(part, element);
-//     }
-        
+       // public static void revealInEditor(IEditorPart part, IJavaElement element)
+       // {
+       // EditorUtility.revealInEditor(part, element);
+       // }
        /**
         * Returns the working copy manager for the Java UI plug-in.
-        *
+        * 
         * @return the working copy manager for the Java UI plug-in
         */
        public static IWorkingCopyManager getWorkingCopyManager() {
                return PHPeclipsePlugin.getDefault().getWorkingCopyManager();
        }
-       
+
        /**
-        * Answers the shared working copies currently registered for the Java plug-in.
-        * Note that the returned array can include working copies that are
+        * Answers the shared working copies currently registered for the Java
+        * plug-in. Note that the returned array can include working copies that are
         * not on the class path of a Java project.
         * 
         * @return the list of shared working copies
@@ -557,7 +653,7 @@ public final class JavaUI {
        public static IWorkingCopy[] getSharedWorkingCopies() {
                return JavaCore.getSharedWorkingCopies(getBufferFactory());
        }
-       
+
        /**
         * Answers the shared working copies that are on the class path of a Java
         * project currently registered for the Java plug-in.
@@ -568,118 +664,126 @@ public final class JavaUI {
         * @see #getSharedWorkingCopies()
         * @since 2.1
         */
-//     public static IWorkingCopy[] getSharedWorkingCopiesOnClasspath() {
-//             IWorkingCopy[] wcs= getSharedWorkingCopies();
-//             List result= new ArrayList(wcs.length);
-//             for (int i = 0; i < wcs.length; i++) {
-//                     IWorkingCopy wc= wcs[i];
-//                     if (wc instanceof IJavaElement) {
-//                             IJavaElement je= (IJavaElement)wc;
-//                             if (je.getJavaProject().isOnClasspath(je)) {
-//                                     result.add(wc);
-//                             }
-//                     }
-//             }
-//             return (IWorkingCopy[])result.toArray(new IWorkingCopy[result.size()]);
-//     }
-        
+       // public static IWorkingCopy[] getSharedWorkingCopiesOnClasspath() {
+       // IWorkingCopy[] wcs= getSharedWorkingCopies();
+       // List result= new ArrayList(wcs.length);
+       // for (int i = 0; i < wcs.length; i++) {
+       // IWorkingCopy wc= wcs[i];
+       // if (wc instanceof IJavaElement) {
+       // IJavaElement je= (IJavaElement)wc;
+       // if (je.getJavaProject().isOnClasspath(je)) {
+       // result.add(wc);
+       // }
+       // }
+       // }
+       // return (IWorkingCopy[])result.toArray(new IWorkingCopy[result.size()]);
+       // }
        /**
         * Returns the BufferFactory for the Java UI plug-in.
-        *
+        * 
         * @return the BufferFactory for the Java UI plug-in
         * 
         * @see net.sourceforge.phpdt.core.IBufferFactory
         * @since 2.0
-        * @deprecated {@link IBufferFactory} has been replaced by {@link net.sourceforge.phpdt.core.WorkingCopyOwner}.
-        * The Java UI plug-in uses the <i>primary working copy owner</i> that can be accessed with <code>null</code> in
-        * API's that require an owner
+        * @deprecated {@link IBufferFactory} has been replaced by
+        *             {@link net.sourceforge.phpdt.core.WorkingCopyOwner}. The
+        *             Java UI plug-in uses the <i>primary working copy owner</i>
+        *             that can be accessed with <code>null</code> in API's that
+        *             require an owner
         */
        public static IBufferFactory getBufferFactory() {
                return PHPeclipsePlugin.getDefault().getBufferFactory();
        }
+
        /**
         * Returns the DocumentProvider used for Java compilation units.
-        *
+        * 
         * @return the DocumentProvider for Java compilation units.
         * 
         * @see IDocumentProvider
         * @since 2.0
         */
        public static IDocumentProvider getDocumentProvider() {
-               return PHPeclipsePlugin.getDefault().getCompilationUnitDocumentProvider();
+               return PHPeclipsePlugin.getDefault()
+                               .getCompilationUnitDocumentProvider();
        }
-               
+
        /**
         * Sets the Javadoc location for an archive with the given path.
         * 
-        * @param archivePath the path of the library; this can be an workspace path
-        * or an external path in case of an external library.
-        * @param url The Javadoc location to set. This location should contain index.html and
-        * a file 'package-list'. <code>null</code> clears the current documentation
-        * location.
+        * @param archivePath
+        *            the path of the library; this can be an workspace path or an
+        *            external path in case of an external library.
+        * @param url
+        *            The Javadoc location to set. This location should contain
+        *            index.html and a file 'package-list'. <code>null</code>
+        *            clears the current documentation location.
         * 
         * @since 2.0
         */
-//     public static void setLibraryJavadocLocation(IPath archivePath, URL url) {
-//             JavaDocLocations.setLibraryJavadocLocation(archivePath, url);
-//     }
-
+       // public static void setLibraryJavadocLocation(IPath archivePath, URL url)
+       // {
+       // JavaDocLocations.setLibraryJavadocLocation(archivePath, url);
+       // }
        /**
         * Returns the Javadoc location for an archive or <code>null</code> if no
         * location is available.
         * 
-        * @param archivePath the path of the library. This can be an workspace path
-        * or an external path in case of an external library.
+        * @param archivePath
+        *            the path of the library. This can be an workspace path or an
+        *            external path in case of an external library.
         * 
         * @since 2.0
-        */     
-//     public static URL getLibraryJavadocLocation(IPath archivePath) {
-//             return JavaDocLocations.getLibraryJavadocLocation(archivePath);
-//     }
-       
+        */
+       // public static URL getLibraryJavadocLocation(IPath archivePath) {
+       // return JavaDocLocations.getLibraryJavadocLocation(archivePath);
+       // }
        /**
         * Sets the Javadoc location for a Java project. This location is used for
         * all types located in the project's source folders.
         * 
-        * @param project the project
-        * @param url The Javadoc location to set. This location should contain index.html and
-        * a file 'package-list'. <code>null</code> clears the current documentation
-        * location.
+        * @param project
+        *            the project
+        * @param url
+        *            The Javadoc location to set. This location should contain
+        *            index.html and a file 'package-list'. <code>null</code>
+        *            clears the current documentation location.
         * 
         * @since 2.1
         */
-//     public static void setProjectJavadocLocation(IJavaProject project, URL url) {
-//             JavaDocLocations.setProjectJavadocLocation(project, url);
-//     }
-
+       // public static void setProjectJavadocLocation(IJavaProject project, URL
+       // url) {
+       // JavaDocLocations.setProjectJavadocLocation(project, url);
+       // }
        /**
-        * Returns the Javadoc location for a Java project or <code>null</code> if no
-        * location is available. This location is used for all types located in the project's
-        * source folders.
+        * Returns the Javadoc location for a Java project or <code>null</code> if
+        * no location is available. This location is used for all types located in
+        * the project's source folders.
         * 
-        * @param project the project
+        * @param project
+        *            the project
         * 
         * @since 2.1
-        */     
-//     public static URL getProjectJavadocLocation(IJavaProject project) {
-//             return JavaDocLocations.getProjectJavadocLocation(project);
-//     }       
-
+        */
+       // public static URL getProjectJavadocLocation(IJavaProject project) {
+       // return JavaDocLocations.getProjectJavadocLocation(project);
+       // }
        /**
-        * Returns the Javadoc base URL for an element. The base location contains the
-        * index file. This location doesn't have to exist. Returns
+        * Returns the Javadoc base URL for an element. The base location contains
+        * the index file. This location doesn't have to exist. Returns
         * <code>null</code> if no javadoc location has been attached to the
         * element's library or project. Example of a returned URL is <i>http://www.
         * junit. org/junit/javadoc</i>.
         * 
-        * @param The element for which the doc URL is requested.
+        * @param The
+        *            element for which the doc URL is requested.
         * 
         * @since 2.0
-        */             
-//     public static URL getJavadocBaseLocation(IJavaElement element) throws JavaModelException {      
-//             return JavaDocLocations.getJavadocBaseLocation(element);
-//     }
-       
+        */
+       // public static URL getJavadocBaseLocation(IJavaElement element) throws
+       // JavaModelException {
+       // return JavaDocLocations.getJavadocBaseLocation(element);
+       // }
        /**
         * Returns the Javadoc URL for an element. Example of a returned URL is
         * <i>http://www.junit.org/junit/javadoc/junit/extensions/TestSetup.html</i>.
@@ -687,14 +791,18 @@ public final class JavaUI {
         * if no javadoc location has been attached to the element's library or
         * project.
         * 
-        * @param The element for which the doc URL is requested.
-        * @param includeAnchor If set, the URL contains an anchor for member references:
-        * <i>http://www.junit.org/junit/javadoc/junit/extensions/TestSetup.html#run(junit.framework.TestResult)</i>. Note
-        * that this involves type resolving and is a more expensive call than without anchor.
+        * @param The
+        *            element for which the doc URL is requested.
+        * @param includeAnchor
+        *            If set, the URL contains an anchor for member references:
+        *            <i>http://www.junit.org/junit/javadoc/junit/extensions/TestSetup.html#run(junit.framework.TestResult)</i>.
+        *            Note that this involves type resolving and is a more expensive
+        *            call than without anchor.
         * 
         * @since 2.0
-        */             
-//     public static URL getJavadocLocation(IJavaElement element, boolean includeAnchor) throws JavaModelException {
-//             return JavaDocLocations.getJavadocLocation(element, includeAnchor);
-//     }
+        */
+       // public static URL getJavadocLocation(IJavaElement element, boolean
+       // includeAnchor) throws JavaModelException {
+       // return JavaDocLocations.getJavadocLocation(element, includeAnchor);
+       // }
 }