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

diff --git a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IPackageFragment.java b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IPackageFragment.java
index 117ee26..73bf9b8 100644
--- a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IPackageFragment.java
+++ b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/IPackageFragment.java
@@ -13,155 +13,187 @@ package net.sourceforge.phpdt.core;
 import org.eclipse.core.runtime.IProgressMonitor;
 
 /**
- * A package fragment is a portion of the workspace corresponding to an entire package,
- * or to a portion thereof. The distinction between a package fragment and a package
- * is that a package with some name is the union of all package fragments in the class path
- * which have the same name.
+ * A package fragment is a portion of the workspace corresponding to an entire
+ * package, or to a portion thereof. The distinction between a package fragment
+ * and a package is that a package with some name is the union of all package
+ * fragments in the class path which have the same name.
  * <p>
- * Package fragments elements need to be opened before they can be navigated or manipulated.
- * The children are of type <code>ICompilationUnit</code> (representing a source file) or 
- * <code>IClassFile</code> (representing a binary class file).
- * The children are listed in no particular order.
+ * Package fragments elements need to be opened before they can be navigated or
+ * manipulated. The children are of type <code>ICompilationUnit</code>
+ * (representing a source file) or <code>IClassFile</code> (representing a
+ * binary class file). The children are listed in no particular order.
  * </p>
  * <p>
  * This interface is not intended to be implemented by clients.
  * </p>
  */
-public interface IPackageFragment extends IParent, IJavaElement, IOpenable { 
-//ISourceManipulation {
+public interface IPackageFragment extends IParent, IJavaElement, IOpenable {
+	// ISourceManipulation {
 
-	/**	
+	/**
 	 * <p>
-	 * The name of package fragment for the default package (value: the empty 
+	 * The name of package fragment for the default package (value: the empty
 	 * string, <code>""</code>).
 	 * </p>
- 	*/
+	 */
 	public static final String DEFAULT_PACKAGE_NAME = ""; //$NON-NLS-1$
+
 	/**
 	 * Returns whether this fragment contains at least one Java resource.
-	 * @return true if this fragment contains at least one Java resource, false otherwise
+	 * 
+	 * @return true if this fragment contains at least one Java resource, false
+	 *         otherwise
 	 */
-//	boolean containsJavaResources() throws JavaModelException;
+	// boolean containsJavaResources() throws JavaModelException;
 	/**
-	 * Creates and returns a compilation unit in this package fragment 
-	 * with the specified name and contents. No verification is performed
-	 * on the contents.
-	 *
-	 * <p>It is possible that a compilation unit with the same name already exists in this 
-	 * package fragment.
-	 * The value of the <code>force</code> parameter effects the resolution of
-	 * such a conflict:<ul>
-	 * <li> <code>true</code> - in this case the compilation is created with the new contents</li>
-	 * <li> <code>false</code> - in this case a <code>JavaModelException</code> is thrown</li>
-	 * </ul>
-	 *
-	 * @param contents the given contents
-	 * @param force specify how to handle conflict is the same name already exists
-	 * @param monitor the given progress monitor
-	 * @param name the given name
-	 * @exception JavaModelException if the element could not be created. Reasons include:
+	 * Creates and returns a compilation unit in this package fragment with the
+	 * specified name and contents. No verification is performed on the
+	 * contents.
+	 * 
+	 * <p>
+	 * It is possible that a compilation unit with the same name already exists
+	 * in this package fragment. The value of the <code>force</code> parameter
+	 * effects the resolution of such a conflict:
 	 * <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> The name is not a valid compilation unit name (INVALID_NAME)
-	 * <li> The contents are <code>null</code> (INVALID_CONTENTS)
+	 * <li> <code>true</code> - in this case the compilation is created with
+	 * the new contents</li>
+	 * <li> <code>false</code> - in this case a
+	 * <code>JavaModelException</code> is thrown</li>
 	 * </ul>
-	 * @return a compilation unit in this package fragment 
-	 * with the specified name and contents
+	 * 
+	 * @param contents
+	 *            the given contents
+	 * @param force
+	 *            specify how to handle conflict is the same name already exists
+	 * @param monitor
+	 *            the given progress monitor
+	 * @param name
+	 *            the given name
+	 * @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> The name is not a valid compilation unit name
+	 *                (INVALID_NAME)
+	 *                <li> The contents are <code>null</code>
+	 *                (INVALID_CONTENTS)
+	 *                </ul>
+	 * @return a compilation unit in this package fragment with the specified
+	 *         name and contents
 	 */
-	ICompilationUnit createCompilationUnit(String name, String contents, boolean force, IProgressMonitor monitor) throws JavaModelException;
+	ICompilationUnit createCompilationUnit(String name, String contents,
+			boolean force, IProgressMonitor monitor) throws JavaModelException;
+
 	/**
-	 * Returns the class file with the specified name
-	 * in this package (for example, <code>"Object.class"</code>).
-	 * The ".class" suffix is required.
-	 * This is a handle-only method.  The class file may or may not be present.
-	 * @param name the given name
+	 * Returns the class file with the specified name in this package (for
+	 * example, <code>"Object.class"</code>). The ".class" suffix is
+	 * required. This is a handle-only method. The class file may or may not be
+	 * present.
+	 * 
+	 * @param name
+	 *            the given name
 	 * @return the class file with the specified name in this package
 	 */
-//	IClassFile getClassFile(String name);
+	// IClassFile getClassFile(String name);
 	/**
 	 * Returns all of the class files in this package fragment.
-	 *
-	 * <p>Note: it is possible that a package fragment contains only
-	 * compilation units (in other words, its kind is <code>K_SOURCE</code>), in
-	 * which case this method returns an empty collection.
-	 *
-	 * @exception JavaModelException if this element does not exist or if an
-	 *		exception occurs while accessing its corresponding resource.
+	 * 
+	 * <p>
+	 * Note: it is possible that a package fragment contains only compilation
+	 * units (in other words, its kind is <code>K_SOURCE</code>), in which
+	 * case this method returns an empty collection.
+	 * 
+	 * @exception JavaModelException
+	 *                if this element does not exist or if an exception occurs
+	 *                while accessing its corresponding resource.
 	 * @return all of the class files in this package fragment
 	 */
-//	IClassFile[] getClassFiles() throws JavaModelException;
+	// IClassFile[] getClassFiles() throws JavaModelException;
 	/**
-	 * Returns the compilation unit with the specified name
-	 * in this package (for example, <code>"Object.java"</code>).
-	 * The name has to be a valid compilation unit name.
-	 * This is a handle-only method.  The compilation unit may or may not be present.
+	 * Returns the compilation unit with the specified name in this package (for
+	 * example, <code>"Object.java"</code>). The name has to be a valid
+	 * compilation unit name. This is a handle-only method. The compilation unit
+	 * may or may not be present.
+	 * 
 	 * @see JavaConventions#validateCompilationUnitName
-	 * @param name the given name
+	 * @param name
+	 *            the given name
 	 * @return the compilation unit with the specified name in this package
 	 */
 	ICompilationUnit getCompilationUnit(String name);
+
 	/**
 	 * Returns all of the compilation units in this package fragment.
-	 *
-	 * <p>Note: it is possible that a package fragment contains only
-	 * class files (in other words, its kind is <code>K_BINARY</code>), in which
-	 * case this method returns an empty collection.
-	 *
-	 * @exception JavaModelException if this element does not exist or if an
-	 *		exception occurs while accessing its corresponding resource.
+	 * 
+	 * <p>
+	 * Note: it is possible that a package fragment contains only class files
+	 * (in other words, its kind is <code>K_BINARY</code>), in which case
+	 * this method returns an empty collection.
+	 * 
+	 * @exception JavaModelException
+	 *                if this element does not exist or if an exception occurs
+	 *                while accessing its corresponding resource.
 	 * @return all of the compilation units in this package fragment
 	 */
 	ICompilationUnit[] getCompilationUnits() throws JavaModelException;
+
 	/**
 	 * Returns the dot-separated package name of this fragment, for example
-	 * <code>"java.lang"</code>, or <code>""</code> (the empty string),
-	 * for the default package.
+	 * <code>"java.lang"</code>, or <code>""</code> (the empty string), for
+	 * the default package.
 	 * 
 	 * @return the dot-separated package name of this fragment
 	 */
 	String getElementName();
+
 	/**
-	 * Returns this package fragment's root kind encoded as an integer.
-	 * A package fragment can contain <code>.java</code> source files,
-	 * or <code>.class</code> files. This is a convenience method.
-	 *
+	 * Returns this package fragment's root kind encoded as an integer. A
+	 * package fragment can contain <code>.java</code> source files, or
+	 * <code>.class</code> files. This is a convenience method.
+	 * 
 	 * @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's root kind encoded as an integer
 	 */
 	int getKind() throws JavaModelException;
+
 	/**
-	 * Returns an array of non-Java resources contained in this package fragment.
+	 * Returns an array of non-Java resources contained in this package
+	 * fragment.
 	 * <p>
 	 * Non-Java resources includes other files and folders located in the same
-	 * directory as the compilation units or class files for this package 
+	 * directory as the compilation units or class files for this package
 	 * fragment. Source files excluded from this package 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).
+	 * considered non-Java resources and will appear in the result (possibly in
+	 * a folder).
 	 * </p>
 	 * 
 	 * @return an array of non-Java resources contained in this package fragment
 	 * @see IClasspathEntry#getExclusionPatterns
 	 */
-//	Object[] getNonJavaResources() throws JavaModelException;
+	// Object[] getNonJavaResources() throws JavaModelException;
 	/**
-	 * Returns whether this package fragment's name is
-	 * a prefix of other package fragments in this package fragment's
-	 * root.
-	 *
-	 * @exception JavaModelException if this element does not exist or if an
-	 *		exception occurs while accessing its corresponding resource.
-	 * @return true if this package fragment's name is a prefix of other package fragments in this package fragment's root, false otherwise
+	 * Returns whether this package fragment's name is a prefix of other package
+	 * fragments in this package fragment's root.
+	 * 
+	 * @exception JavaModelException
+	 *                if this element does not exist or if an exception occurs
+	 *                while accessing its corresponding resource.
+	 * @return true if this package fragment's name is a prefix of other package
+	 *         fragments in this package fragment's root, false otherwise
 	 */
-//	boolean hasSubpackages() throws JavaModelException;
+	// boolean hasSubpackages() throws JavaModelException;
 	/**
-	 * Returns whether this package fragment is a default package.
-	 * This is a handle-only method.
+	 * Returns whether this package fragment is a default package. This is a
+	 * handle-only method.
 	 * 
 	 * @return true if this package fragment is a default package
 	 */