X-Git-Url: http://git.phpeclipse.com

diff --git a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IPackageFragmentRoot.java b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IPackageFragmentRoot.java
index ba8d7ea..f96a997 100644
--- a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IPackageFragmentRoot.java
+++ b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IPackageFragmentRoot.java
@@ -18,401 +18,462 @@
  *******************************************************************************/
 package net.sourceforge.phpdt.core;
 
-
 /**
- * A package fragment root contains a set of package fragments.
- * It corresponds to an underlying resource which is either a folder,
- * JAR, or zip.  In the case of a folder, all descendant folders represent
- * package fragments.  For a given child folder representing a package fragment, 
- * the corresponding package name is composed of the folder names between the folder 
- * for this root and the child folder representing the package, separated by '.'.
- * In the case of a JAR or zip, the contents of the archive dictates 
- * the set of package fragments in an analogous manner.
- * Package fragment roots need to be opened before they can be navigated or manipulated.
- * The children are of type <code>IPackageFragment</code>, and are in no particular order.
+ * A package fragment root contains a set of package fragments. It corresponds
+ * to an underlying resource which is either a folder, JAR, or zip. In the case
+ * of a folder, all descendant folders represent package fragments. For a given
+ * child folder representing a package fragment, the corresponding package name
+ * is composed of the folder names between the folder for this root and the
+ * child folder representing the package, separated by '.'. In the case of a JAR
+ * or zip, the contents of the archive dictates the set of package fragments in
+ * an analogous manner. Package fragment roots need to be opened before they can
+ * be navigated or manipulated. The children are of type
+ * <code>IPackageFragment</code>, and are in no particular order.
  * <p>
  * This interface is not intended to be implemented by clients.
  * </p>
  */
-public interface IPackageFragmentRoot
-	extends IParent, IJavaElement, IOpenable {
+public interface IPackageFragmentRoot extends IParent, IJavaElement, IOpenable {
 	/**
-	 * Kind constant for a source path root. Indicates this root
-	 * only contains source files.
+	 * Kind constant for a source path root. Indicates this root only contains
+	 * source files.
 	 */
 	int K_SOURCE = 1;
+
 	/**
-	 * Kind constant for a binary path root. Indicates this
-	 * root only contains binary files.
+	 * Kind constant for a binary path root. Indicates this root only contains
+	 * binary files.
 	 */
 	int K_BINARY = 2;
+
 	/**
 	 * Empty root path
 	 */
 	String DEFAULT_PACKAGEROOT_PATH = ""; //$NON-NLS-1$
+
 	/**
-	 * Update model flag constant (bit mask value 1) indicating that the operation
-	 * is to not copy/move/delete the package fragment root resource.
+	 * Update model flag constant (bit mask value 1) indicating that the
+	 * operation is to not copy/move/delete the package fragment root resource.
+	 * 
 	 * @since 2.1
 	 */
 	int NO_RESOURCE_MODIFICATION = 1;
+
 	/**
-	 * Update model flag constant (bit mask value 2) indicating that the operation
-	 * is to update the classpath of the originating project.
+	 * Update model flag constant (bit mask value 2) indicating that the
+	 * operation is to update the classpath of the originating project.
+	 * 
 	 * @since 2.1
 	 */
 	int ORIGINATING_PROJECT_CLASSPATH = 2;
+
 	/**
-	 * Update model flag constant (bit mask value 4) indicating that the operation
-	 * is to update the classpath of all referring projects except the originating project.
+	 * Update model flag constant (bit mask value 4) indicating that the
+	 * operation is to update the classpath of all referring projects except the
+	 * originating project.
+	 * 
 	 * @since 2.1
 	 */
 	int OTHER_REFERRING_PROJECTS_CLASSPATH = 4;
+
 	/**
-	 * Update model flag constant (bit mask value 8) indicating that the operation
-	 * is to update the classpath of the destination project.
+	 * Update model flag constant (bit mask value 8) indicating that the
+	 * operation is to update the classpath of the destination project.
+	 * 
 	 * @since 2.1
 	 */
-	int DESTINATION_PROJECT_CLASSPATH = 8;	
+	int DESTINATION_PROJECT_CLASSPATH = 8;
+
 	/**
-	 * Update model flag constant (bit mask value 16) indicating that the operation
-	 * is to replace the resource and the destination project's classpath entry.
+	 * Update model flag constant (bit mask value 16) indicating that the
+	 * operation is to replace the resource and the destination project's
+	 * classpath entry.
+	 * 
 	 * @since 2.1
 	 */
-	int REPLACE = 16;	
+	int REPLACE = 16;
+
 	/**
 	 * Attaches the source archive identified by the given absolute path to this
-	 * binary package fragment root. <code>rootPath</code> specifies the location 
-	 * of the root within the archive or folder (empty specifies the default root 
-	 * and <code>null</code> specifies the root path should be detected).
-	 * Once a source archive or folder is attached to the package fragment root,
-	 * the <code>getSource</code> and <code>getSourceRange</code>
-	 * methods become operational for binary types/members.
-	 * To detach a source archive or folder from a package fragment root, specify 
-	 * <code>null</code> as the source path.
-	 *
-	 * @param sourcePath the given absolute path to the source archive or folder
-	 * @param rootPath specifies the location of the root within the archive 
-	 *              (empty specifies the default root and <code>null</code> specifies 
-	 *               automatic detection of the root path)
-	 * @param monitor the given progress monitor
-	 * @exception JavaModelException if this operation fails. Reasons include:
-	 * <ul>
-	 * <li> This Java element does not exist (ELEMENT_DOES_NOT_EXIST)</li>
-	 * <li> A <code>CoreException</code> occurred while updating a server property
-	 * <li> This package fragment root is not of kind binary (INVALID_ELEMENT_TYPES)
-	 * <li> The path provided is not absolute (RELATIVE_PATH)
-	 * </ul>
+	 * binary package fragment root. <code>rootPath</code> specifies the
+	 * location of the root within the archive or folder (empty specifies the
+	 * default root and <code>null</code> specifies the root path should be
+	 * detected). Once a source archive or folder is attached to the package
+	 * fragment root, the <code>getSource</code> and
+	 * <code>getSourceRange</code> methods become operational for binary
+	 * types/members. To detach a source archive or folder from a package
+	 * fragment root, specify <code>null</code> as the source path.
+	 * 
+	 * @param sourcePath
+	 *            the given absolute path to the source archive or folder
+	 * @param rootPath
+	 *            specifies the location of the root within the archive (empty
+	 *            specifies the default root and <code>null</code> specifies
+	 *            automatic detection of the root path)
+	 * @param monitor
+	 *            the given progress monitor
+	 * @exception JavaModelException
+	 *                if this operation fails. Reasons include:
+	 *                <ul>
+	 *                <li> This Java element does not exist
+	 *                (ELEMENT_DOES_NOT_EXIST)</li>
+	 *                <li> A <code>CoreException</code> occurred while
+	 *                updating a server property
+	 *                <li> This package fragment root is not of kind binary
+	 *                (INVALID_ELEMENT_TYPES)
+	 *                <li> The path provided is not absolute (RELATIVE_PATH)
+	 *                </ul>
 	 */
-//	void attachSource(IPath sourcePath, IPath rootPath, IProgressMonitor monitor)
-//		throws JavaModelException;
-
+	// void attachSource(IPath sourcePath, IPath rootPath, IProgressMonitor
+	// monitor)
+	// throws JavaModelException;
 	/**
 	 * Copies the resource of this package fragment root to the destination path
 	 * as specified by <code>IResource.copy(IPath, int, IProgressMonitor)</code>
 	 * but excluding nested source folders.
 	 * <p>
-	 * If <code>NO_RESOURCE_MODIFICATION</code> is specified in 
-	 * <code>updateModelFlags</code> or if this package fragment root is external, 
-	 * this operation doesn't copy the resource. <code>updateResourceFlags</code> 
-	 * is then ignored.
-	 * </p><p>
-	 * If <code>DESTINATION_PROJECT_CLASSPATH</code> is specified in 
-	 * <code>updateModelFlags</code>, updates the classpath of the 
-	 * destination's project (if it is a Java project). If a non-<code>null</code> 
-	 * sibling is specified, a copy of this root's classpath entry is inserted before the 
-	 * sibling on the destination project's raw classpath. If <code>null</code> is 
-	 * specified, the classpath entry is added at the end of the raw classpath.
-	 * </p><p>
+	 * If <code>NO_RESOURCE_MODIFICATION</code> is specified in
+	 * <code>updateModelFlags</code> or if this package fragment root is
+	 * external, this operation doesn't copy the resource.
+	 * <code>updateResourceFlags</code> is then ignored.
+	 * </p>
+	 * <p>
+	 * If <code>DESTINATION_PROJECT_CLASSPATH</code> is specified in
+	 * <code>updateModelFlags</code>, updates the classpath of the
+	 * destination's project (if it is a Java project). If a non-<code>null</code>
+	 * sibling is specified, a copy of this root's classpath entry is inserted
+	 * before the sibling on the destination project's raw classpath. If
+	 * <code>null</code> is specified, the classpath entry is added at the end
+	 * of the raw classpath.
+	 * </p>
+	 * <p>
 	 * If <code>REPLACE</code> is specified in <code>updateModelFlags</code>,
-	 * overwrites the resource at the destination path if any.
-	 * If the same classpath entry already exists on the destination project's raw
-	 * classpath, then the sibling is ignored and the new classpath entry replaces the 
-	 * existing one.
-	 * </p><p>
-	 * If no flags is specified in <code>updateModelFlags</code> (using 
+	 * overwrites the resource at the destination path if any. If the same
+	 * classpath entry already exists on the destination project's raw
+	 * classpath, then the sibling is ignored and the new classpath entry
+	 * replaces the existing one.
+	 * </p>
+	 * <p>
+	 * If no flags is specified in <code>updateModelFlags</code> (using
 	 * <code>IResource.NONE</code>), the default behavior applies: the
-	 * resource is copied (if this package fragment root is not external) and the
-	 * classpath is not updated.
+	 * resource is copied (if this package fragment root is not external) and
+	 * the classpath is not updated.
 	 * </p>
 	 * 
-	 * @param destination the destination path
-	 * @param updateResourceFlags bit-wise or of update resource flag constants
-	 *   (<code>IResource.FORCE</code> and <code>IResource.SHALLOW</code>)
-	 * @param updateModelFlags bit-wise or of update resource flag constants
-	 *   (<code>DESTINATION_PROJECT_CLASSPATH</code> and 
-	 *   <code>NO_RESOURCE_MODIFICATION</code>)
-	 * @param sibling the classpath entry before which a copy of the classpath
-	 * entry should be inserted or <code>null</code> if the classpath entry should
-	 * be inserted at the end
-	 * @param monitor a progress monitor
+	 * @param destination
+	 *            the destination path
+	 * @param updateResourceFlags
+	 *            bit-wise or of update resource flag constants (<code>IResource.FORCE</code>
+	 *            and <code>IResource.SHALLOW</code>)
+	 * @param updateModelFlags
+	 *            bit-wise or of update resource flag constants (<code>DESTINATION_PROJECT_CLASSPATH</code>
+	 *            and <code>NO_RESOURCE_MODIFICATION</code>)
+	 * @param sibling
+	 *            the classpath entry before which a copy of the classpath entry
+	 *            should be inserted or <code>null</code> if the classpath
+	 *            entry should be inserted at the end
+	 * @param monitor
+	 *            a progress monitor
 	 * 
-	 * @exception JavaModelException if this root could not be copied. Reasons
-	 * include:
-	 * <ul>
-	 * <li> This root does not exist (ELEMENT_DOES_NOT_EXIST)</li>
-	 * <li> A <code>CoreException</code> occurred while copying the
-	 * resource or updating a classpath</li>
-	 * <li>
-	 * The destination is not inside an existing project and <code>updateModelFlags</code>
-	 * has been specified as <code>DESTINATION_PROJECT_CLASSPATH</code> 
-	 * (INVALID_DESTINATION)</li>
-	 * <li> The sibling is not a classpath entry on the destination project's
-	 * raw classpath (INVALID_SIBLING)</li>
-	 * <li> The same classpath entry already exists on the destination project's
-	 * classpath (NAME_COLLISION) and <code>updateModelFlags</code>
-	 * has not been specified as <code>REPLACE</code></li>
-	 * </ul>
+	 * @exception JavaModelException
+	 *                if this root could not be copied. Reasons include:
+	 *                <ul>
+	 *                <li> This root does not exist (ELEMENT_DOES_NOT_EXIST)</li>
+	 *                <li> A <code>CoreException</code> occurred while copying
+	 *                the resource or updating a classpath</li>
+	 *                <li> The destination is not inside an existing project and
+	 *                <code>updateModelFlags</code> has been specified as
+	 *                <code>DESTINATION_PROJECT_CLASSPATH</code>
+	 *                (INVALID_DESTINATION)</li>
+	 *                <li> The sibling is not a classpath entry on the
+	 *                destination project's raw classpath (INVALID_SIBLING)</li>
+	 *                <li> The same classpath entry already exists on the
+	 *                destination project's classpath (NAME_COLLISION) and
+	 *                <code>updateModelFlags</code> has not been specified as
+	 *                <code>REPLACE</code></li>
+	 *                </ul>
 	 * @see org.eclipse.core.resources.IResource#copy
 	 * @since 2.1
 	 */
-//	void copy(IPath destination, int updateResourceFlags, int updateModelFlags, IClasspathEntry sibling, IProgressMonitor monitor) throws JavaModelException;
+	// void copy(IPath destination, int updateResourceFlags, int
+	// updateModelFlags, IClasspathEntry sibling, IProgressMonitor monitor)
+	// throws JavaModelException;
 	/**
-	 * Creates and returns a package fragment in this root with the 
-	 * given dot-separated package name.  An empty string specifies the default package. 
-	 * This has the side effect of creating all package
-	 * fragments that are a prefix of the new package fragment which
-	 * do not exist yet. If the package fragment already exists, this
-	 * has no effect.
-	 *
-	 * For a description of the <code>force</code> flag, see <code>IFolder.create</code>.
-	 *
-	 * @param name the given dot-separated package name
-	 * @param force a flag controlling how to deal with resources that
-	 *    are not in sync with the local file system
-	 * @param monitor the given progress monitor
-	 * @exception JavaModelException if the element could not be created. Reasons include:
-	 * <ul>
-	 * <li> This Java element does not exist (ELEMENT_DOES_NOT_EXIST)</li>
-	 * <li> A <code>CoreException</code> occurred while creating an underlying resource
-	 * <li> This package fragment root is read only (READ_ONLY)
-	 * <li> The name is not a valid package name (INVALID_NAME)
-	 * </ul>
-	 * @return a package fragment in this root with the given dot-separated package name
+	 * Creates and returns a package fragment in this root with the given
+	 * dot-separated package name. An empty string specifies the default
+	 * package. This has the side effect of creating all package fragments that
+	 * are a prefix of the new package fragment which do not exist yet. If the
+	 * package fragment already exists, this has no effect.
+	 * 
+	 * For a description of the <code>force</code> flag, see
+	 * <code>IFolder.create</code>.
+	 * 
+	 * @param name
+	 *            the given dot-separated package name
+	 * @param force
+	 *            a flag controlling how to deal with resources that are not in
+	 *            sync with the local file system
+	 * @param monitor
+	 *            the given progress monitor
+	 * @exception JavaModelException
+	 *                if the element could not be created. Reasons include:
+	 *                <ul>
+	 *                <li> This Java element does not exist
+	 *                (ELEMENT_DOES_NOT_EXIST)</li>
+	 *                <li> A <code>CoreException</code> occurred while
+	 *                creating an underlying resource
+	 *                <li> This package fragment root is read only (READ_ONLY)
+	 *                <li> The name is not a valid package name (INVALID_NAME)
+	 *                </ul>
+	 * @return a package fragment in this root with the given dot-separated
+	 *         package name
 	 * @see org.eclipse.core.resources.IFolder#create
 	 */
-//	IPackageFragment createPackageFragment(
-//		String name,
-//		boolean force,
-//		IProgressMonitor monitor)
-//		throws JavaModelException;
+	// IPackageFragment createPackageFragment(
+	// String name,
+	// boolean force,
+	// IProgressMonitor monitor)
+	// throws JavaModelException;
 	/**
 	 * Deletes the resource of this package fragment root as specified by
-	 * <code>IResource.delete(int, IProgressMonitor)</code> but excluding nested
-	 * source folders.
+	 * <code>IResource.delete(int, IProgressMonitor)</code> but excluding
+	 * nested source folders.
+	 * <p>
+	 * If <code>NO_RESOURCE_MODIFICATION</code> is specified in
+	 * <code>updateModelFlags</code> or if this package fragment root is
+	 * external, this operation doesn't delete the resource.
+	 * <code>updateResourceFlags</code> is then ignored.
+	 * </p>
 	 * <p>
-	 * If <code>NO_RESOURCE_MODIFICATION</code> is specified in 
-	 * <code>updateModelFlags</code> or if this package fragment root is external, 
-	 * this operation doesn't delete the resource. <code>updateResourceFlags</code> 
-	 * is then ignored.
-	 * </p><p>
-	 * If <code>ORIGINATING_PROJECT_CLASSPATH</code> is specified in 
-	 * <code>updateModelFlags</code>, update the raw classpath of this package 
-	 * fragment root's project by removing the corresponding classpath entry.
-	 * </p><p>
-	 * If <code>OTHER_REFERRING_PROJECTS_CLASSPATH</code> is specified in 
-	 * <code>updateModelFlags</code>, update the raw classpaths of all other Java
-	 * projects referring to this root's resource by removing the corresponding classpath 
-	 * entries.
-	 * </p><p>
-	 * If no flags is specified in <code>updateModelFlags</code> (using 
+	 * If <code>ORIGINATING_PROJECT_CLASSPATH</code> is specified in
+	 * <code>updateModelFlags</code>, update the raw classpath of this
+	 * package fragment root's project by removing the corresponding classpath
+	 * entry.
+	 * </p>
+	 * <p>
+	 * If <code>OTHER_REFERRING_PROJECTS_CLASSPATH</code> is specified in
+	 * <code>updateModelFlags</code>, update the raw classpaths of all other
+	 * Java projects referring to this root's resource by removing the
+	 * corresponding classpath entries.
+	 * </p>
+	 * <p>
+	 * If no flags is specified in <code>updateModelFlags</code> (using
 	 * <code>IResource.NONE</code>), the default behavior applies: the
-	 * resource is deleted (if this package fragment root is not external) and no
-	 * classpaths are updated.
+	 * resource is deleted (if this package fragment root is not external) and
+	 * no classpaths are updated.
 	 * </p>
 	 * 
-	 * @param updateResourceFlags bit-wise or of update resource flag constants
-	 *   (<code>IResource.FORCE</code> and <code>IResource.KEEP_HISTORY</code>)
-	 * @param updateModelFlags bit-wise or of update resource flag constants
-	 *   (<code>ORIGINATING_PROJECT_CLASSPATH</code>,
-	 *   <code>OTHER_REFERRING_PROJECTS_CLASSPATH</code> and 
-	 *   <code>NO_RESOURCE_MODIFICATION</code>)
-	 * @param monitor a progress monitor
+	 * @param updateResourceFlags
+	 *            bit-wise or of update resource flag constants (<code>IResource.FORCE</code>
+	 *            and <code>IResource.KEEP_HISTORY</code>)
+	 * @param updateModelFlags
+	 *            bit-wise or of update resource flag constants (<code>ORIGINATING_PROJECT_CLASSPATH</code>,
+	 *            <code>OTHER_REFERRING_PROJECTS_CLASSPATH</code> and
+	 *            <code>NO_RESOURCE_MODIFICATION</code>)
+	 * @param monitor
+	 *            a progress monitor
 	 * 
-	 * @exception JavaModelException if this root could not be deleted. Reasons
-	 * include:
-	 * <ul>
-	 * <li> This root does not exist (ELEMENT_DOES_NOT_EXIST)</li>
-	 * <li> A <code>CoreException</code> occurred while deleting the resource 
-	 * or updating a classpath
-	 * </li>
-	 * </ul>
+	 * @exception JavaModelException
+	 *                if this root could not be deleted. Reasons include:
+	 *                <ul>
+	 *                <li> This root does not exist (ELEMENT_DOES_NOT_EXIST)</li>
+	 *                <li> A <code>CoreException</code> occurred while
+	 *                deleting the resource or updating a classpath </li>
+	 *                </ul>
 	 * @see org.eclipse.core.resources.IResource#delete
 	 * @since 2.1
 	 */
-//	void delete(int updateResourceFlags, int updateModelFlags, IProgressMonitor monitor) throws JavaModelException;
+	// void delete(int updateResourceFlags, int updateModelFlags,
+	// IProgressMonitor monitor) throws JavaModelException;
 	/**
-	 * Returns this package fragment root's kind encoded as an integer.
-	 * A package fragment root can contain <code>.java</code> source files,
-	 * or <code>.class</code> files, but not both.
-	 * If the underlying folder or archive contains other kinds of files, they are ignored.
-	 * In particular, <code>.class</code> files are ignored under a source package fragment root,
-	 * and <code>.java</code> files are ignored under a binary package fragment root.
-	 *
+	 * Returns this package fragment root's kind encoded as an integer. A
+	 * package fragment root can contain <code>.java</code> source files, or
+	 * <code>.class</code> files, but not both. If the underlying folder or
+	 * archive contains other kinds of files, they are ignored. In particular,
+	 * <code>.class</code> files are ignored under a source package fragment
+	 * root, and <code>.java</code> files are ignored under a binary package
+	 * fragment root.
+	 * 
 	 * @see IPackageFragmentRoot#K_SOURCE
 	 * @see IPackageFragmentRoot#K_BINARY
-	 *
-	 * @exception JavaModelException if this element does not exist or if an
-	 *		exception occurs while accessing its corresponding resource.
+	 * 
+	 * @exception JavaModelException
+	 *                if this element does not exist or if an exception occurs
+	 *                while accessing its corresponding resource.
 	 * @return this package fragment root's kind encoded as an integer
 	 */
-//	int getKind() throws JavaModelException;
-	
+	int getKind() throws JavaModelException;
+
 	/**
-	 * Returns an array of non-Java resources contained in this package fragment root.
+	 * Returns an array of non-Java resources contained in this package fragment
+	 * root.
 	 * <p>
 	 * Non-Java resources includes other files and folders located in the same
 	 * directories as the compilation units or class files under this package
-	 * fragment root. Resources excluded from this package fragment root
-	 * by one or more exclusion patterns on the corresponding source classpath
-	 * entry are considered non-Java resources and will appear in the result
-	 * (possibly in a folder). Thus when a nested source folder is excluded, it will appear
-	 * in the non-Java resources of the outer folder.
+	 * fragment root. Resources excluded from this package fragment root by one
+	 * or more exclusion patterns on the corresponding source classpath entry
+	 * are considered non-Java resources and will appear in the result (possibly
+	 * in a folder). Thus when a nested source folder is excluded, it will
+	 * appear in the non-Java resources of the outer folder.
 	 * </p>
-	 * @return an array of non-Java resources contained in this package fragment root
+	 * 
+	 * @return an array of non-Java resources contained in this package fragment
+	 *         root
 	 * @see IClasspathEntry#getExclusionPatterns
 	 */
-//	Object[] getNonJavaResources() throws JavaModelException;
-	
+	// Object[] getNonJavaResources() throws JavaModelException;
 	/**
-	 * Returns the package fragment with the given package name.
-	 * An empty string indicates the default package.
-	 * This is a handle-only operation.  The package fragment
-	 * may or may not exist.
+	 * Returns the package fragment with the given package name. An empty string
+	 * indicates the default package. This is a handle-only operation. The
+	 * package fragment may or may not exist.
 	 * 
-	 * @param packageName the given package name
+	 * @param packageName
+	 *            the given package name
 	 * @return the package fragment with the given package name
 	 */
 	IPackageFragment getPackageFragment(String packageName);
-	
 
 	/**
 	 * Returns the first raw classpath entry that corresponds to this package
-	 * fragment root.
-	 * A raw classpath entry corresponds to a package fragment root if once resolved
-	 * this entry's path is equal to the root's path. 
+	 * fragment root. A raw classpath entry corresponds to a package fragment
+	 * root if once resolved this entry's path is equal to the root's path.
 	 * 
-	 * @exception JavaModelException if this element does not exist or if an
-	 *		exception occurs while accessing its corresponding resource.
-	 * @return the first raw classpath entry that corresponds to this package fragment root
+	 * @exception JavaModelException
+	 *                if this element does not exist or if an exception occurs
+	 *                while accessing its corresponding resource.
+	 * @return the first raw classpath entry that corresponds to this package
+	 *         fragment root
 	 * @since 2.0
 	 */
-//	IClasspathEntry getRawClasspathEntry() throws JavaModelException;
-	
+	// IClasspathEntry getRawClasspathEntry() throws JavaModelException;
 	/**
-	 * Returns the absolute path to the source archive attached to
-	 * this package fragment root's binary archive.
-	 *
-	 * @return the absolute path to the corresponding source archive, 
-	 *   or <code>null</code> if this package fragment root's binary archive
-	 *   has no corresponding source archive, or if this package fragment root
-	 *   is not a binary archive
-	 * @exception JavaModelException if this operation fails
+	 * Returns the absolute path to the source archive attached to this package
+	 * fragment root's binary archive.
+	 * 
+	 * @return the absolute path to the corresponding source archive, or
+	 *         <code>null</code> if this package fragment root's binary
+	 *         archive has no corresponding source archive, or if this package
+	 *         fragment root is not a binary archive
+	 * @exception JavaModelException
+	 *                if this operation fails
 	 */
-//	IPath getSourceAttachmentPath() throws JavaModelException;
-	
+	// IPath getSourceAttachmentPath() throws JavaModelException;
 	/**
-	 * Returns the path within this package fragment root's source archive. 
-	 * An empty path indicates that packages are located at the root of the
-	 * source archive.
-	 *
-	 * @return the path within the corresponding source archive, 
-	 *   or <code>null</code> if this package fragment root's binary archive
-	 *   has no corresponding source archive, or if this package fragment root
-	 *   is not a binary archive
-	 * @exception JavaModelException if this operation fails
+	 * Returns the path within this package fragment root's source archive. An
+	 * empty path indicates that packages are located at the root of the source
+	 * archive.
+	 * 
+	 * @return the path within the corresponding source archive, or
+	 *         <code>null</code> if this package fragment root's binary
+	 *         archive has no corresponding source archive, or if this package
+	 *         fragment root is not a binary archive
+	 * @exception JavaModelException
+	 *                if this operation fails
 	 */
-//	IPath getSourceAttachmentRootPath() throws JavaModelException;
-	
+	// IPath getSourceAttachmentRootPath() throws JavaModelException;
 	/**
-	 * Returns whether this package fragment root's underlying
-	 * resource is a binary archive (a JAR or zip file).
+	 * Returns whether this package fragment root's underlying resource is a
+	 * binary archive (a JAR or zip file).
 	 * 
-	 * @return true if this package fragment root's underlying resource is a binary archive, false otherwise
+	 * @return true if this package fragment root's underlying resource is a
+	 *         binary archive, false otherwise
 	 */
 	public boolean isArchive();
-	
+
 	/**
-	 * Returns whether this package fragment root is external
-	 * to the workbench (that is, a local file), and has no
-	 * underlying resource.
+	 * Returns whether this package fragment root is external to the workbench
+	 * (that is, a local file), and has no underlying resource.
 	 * 
-	 * @return true if this package fragment root is external
-	 * to the workbench (that is, a local file), and has no
-	 * underlying resource, false otherwise
+	 * @return true if this package fragment root is external to the workbench
+	 *         (that is, a local file), and has no underlying resource, false
+	 *         otherwise
 	 */
 	boolean isExternal();
-	
+
 	/**
 	 * Moves the resource of this package fragment root to the destination path
 	 * as specified by <code>IResource.move(IPath,int,IProgressMonitor)</code>
 	 * but excluding nested source folders.
 	 * <p>
-	 * If <code>NO_RESOURCE_MODIFICATION</code> is specified in 
-	 * <code>updateModelFlags</code> or if this package fragment root is external, 
-	 * this operation doesn't move the resource. <code>updateResourceFlags</code> 
-	 * is then ignored.
-	 * </p><p>
-	 * If <code>DESTINATION_PROJECT_CLASSPATH</code> is specified in 
-	 * <code>updateModelFlags</code>, updates the classpath of the 
-	 * destination's project (if it is a Java project). If a non-<code>null</code> 
-	 * sibling is specified, a copy of this root's classpath entry is inserted before the 
-	 * sibling on the destination project's raw classpath. If <code>null</code> is 
-	 * specified, the classpath entry is added at the end of the raw classpath.
-	 * </p><p>
-	 * If <code>ORIGINATING_PROJECT_CLASSPATH</code> is specified in 
-	 * <code>updateModelFlags</code>, update the raw classpath of this package 
-	 * fragment root's project by removing the corresponding classpath entry.
-	 * </p><p>
-	 * If <code>OTHER_REFERRING_PROJECTS_CLASSPATH</code> is specified in 
-	 * <code>updateModelFlags</code>, update the raw classpaths of all other Java
-	 * projects referring to this root's resource by removing the corresponding classpath 
-	 * entries.
-	 * </p><p>
+	 * If <code>NO_RESOURCE_MODIFICATION</code> is specified in
+	 * <code>updateModelFlags</code> or if this package fragment root is
+	 * external, this operation doesn't move the resource.
+	 * <code>updateResourceFlags</code> is then ignored.
+	 * </p>
+	 * <p>
+	 * If <code>DESTINATION_PROJECT_CLASSPATH</code> is specified in
+	 * <code>updateModelFlags</code>, updates the classpath of the
+	 * destination's project (if it is a Java project). If a non-<code>null</code>
+	 * sibling is specified, a copy of this root's classpath entry is inserted
+	 * before the sibling on the destination project's raw classpath. If
+	 * <code>null</code> is specified, the classpath entry is added at the end
+	 * of the raw classpath.
+	 * </p>
+	 * <p>
+	 * If <code>ORIGINATING_PROJECT_CLASSPATH</code> is specified in
+	 * <code>updateModelFlags</code>, update the raw classpath of this
+	 * package fragment root's project by removing the corresponding classpath
+	 * entry.
+	 * </p>
+	 * <p>
+	 * If <code>OTHER_REFERRING_PROJECTS_CLASSPATH</code> is specified in
+	 * <code>updateModelFlags</code>, update the raw classpaths of all other
+	 * Java projects referring to this root's resource by removing the
+	 * corresponding classpath entries.
+	 * </p>
+	 * <p>
 	 * If <code>REPLACE</code> is specified in <code>updateModelFlags</code>,
-	 * overwrites the resource at the destination path if any.
-	 * If the same classpath entry already exists on the destination project's raw
-	 * classpath, then the sibling is ignored and the new classpath entry replaces the 
-	 * existing one.
-	 * </p><p>
-	 * If no flags is specified in <code>updateModelFlags</code> (using 
+	 * overwrites the resource at the destination path if any. If the same
+	 * classpath entry already exists on the destination project's raw
+	 * classpath, then the sibling is ignored and the new classpath entry
+	 * replaces the existing one.
+	 * </p>
+	 * <p>
+	 * If no flags is specified in <code>updateModelFlags</code> (using
 	 * <code>IResource.NONE</code>), the default behavior applies: the
 	 * resource is moved (if this package fragment root is not external) and no
 	 * classpaths are updated.
 	 * </p>
 	 * 
-	 * @param destination the destination path
-	 * @param updateFlags bit-wise or of update flag constants
-	 * (<code>IResource.FORCE</code>, <code>IResource.KEEP_HISTORY</code> 
-	 * and <code>IResource.SHALLOW</code>)
-	 * @param updateModelFlags bit-wise or of update resource flag constants
-	 *   (<code>DESTINATION_PROJECT_CLASSPATH</code>,
-	 *   <code>ORIGINATING_PROJECT_CLASSPATH</code>,
-	 *   <code>OTHER_REFERRING_PROJECTS_CLASSPATH</code> and 
-	 *   <code>NO_RESOURCE_MODIFICATION</code>)
-	 * @param sibling the classpath entry before which a copy of the classpath
-	 * entry should be inserted or <code>null</code> if the classpath entry should
-	 * be inserted at the end
-	 * @param monitor a progress monitor
+	 * @param destination
+	 *            the destination path
+	 * @param updateFlags
+	 *            bit-wise or of update flag constants (<code>IResource.FORCE</code>,
+	 *            <code>IResource.KEEP_HISTORY</code> and
+	 *            <code>IResource.SHALLOW</code>)
+	 * @param updateModelFlags
+	 *            bit-wise or of update resource flag constants (<code>DESTINATION_PROJECT_CLASSPATH</code>,
+	 *            <code>ORIGINATING_PROJECT_CLASSPATH</code>,
+	 *            <code>OTHER_REFERRING_PROJECTS_CLASSPATH</code> and
+	 *            <code>NO_RESOURCE_MODIFICATION</code>)
+	 * @param sibling
+	 *            the classpath entry before which a copy of the classpath entry
+	 *            should be inserted or <code>null</code> if the classpath
+	 *            entry should be inserted at the end
+	 * @param monitor
+	 *            a progress monitor
 	 * 
-	 * @exception JavaModelException if this root could not be moved. Reasons
-	 * include:
-	 * <ul>
-	 * <li> This root does not exist (ELEMENT_DOES_NOT_EXIST)</li>
-	 * <li> A <code>CoreException</code> occurred while copying the
-	 * resource or updating a classpath</li>
-	 * <li>
-	 * The destination is not inside an existing project and <code>updateModelFlags</code>
-	 * has been specified as <code>DESTINATION_PROJECT_CLASSPATH</code> 
-	 * (INVALID_DESTINATION)</li>
-	 * <li> The sibling is not a classpath entry on the destination project's
-	 * raw classpath (INVALID_SIBLING)</li>
-	 * <li> The same classpath entry already exists on the destination project's
-	 * classpath (NAME_COLLISION) and <code>updateModelFlags</code>
-	 * has not been specified as <code>REPLACE</code></li>
-	 * </ul>
+	 * @exception JavaModelException
+	 *                if this root could not be moved. Reasons include:
+	 *                <ul>
+	 *                <li> This root does not exist (ELEMENT_DOES_NOT_EXIST)</li>
+	 *                <li> A <code>CoreException</code> occurred while copying
+	 *                the resource or updating a classpath</li>
+	 *                <li> The destination is not inside an existing project and
+	 *                <code>updateModelFlags</code> has been specified as
+	 *                <code>DESTINATION_PROJECT_CLASSPATH</code>
+	 *                (INVALID_DESTINATION)</li>
+	 *                <li> The sibling is not a classpath entry on the
+	 *                destination project's raw classpath (INVALID_SIBLING)</li>
+	 *                <li> The same classpath entry already exists on the
+	 *                destination project's classpath (NAME_COLLISION) and
+	 *                <code>updateModelFlags</code> has not been specified as
+	 *                <code>REPLACE</code></li>
+	 *                </ul>
 	 * @see org.eclipse.core.resources.IResource#move
 	 * @since 2.1
 	 */
-//	void move(IPath destination, int updateResourceFlags, int updateModelFlags, IClasspathEntry sibling, IProgressMonitor monitor) throws JavaModelException;
+	// void move(IPath destination, int updateResourceFlags, int
+	// updateModelFlags, IClasspathEntry sibling, IProgressMonitor monitor)
+	// throws JavaModelException;
 }
\ No newline at end of file