Added patch for #1589521 "3 character function names invalid?"
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpdt / ui / IWorkingCopyManager.java
index bab2691..e0be2c6 100644 (file)
  *******************************************************************************/
 package net.sourceforge.phpdt.ui;
 
-import org.eclipse.core.runtime.CoreException;
+import net.sourceforge.phpdt.core.ICompilationUnit;
 
+import org.eclipse.core.runtime.CoreException;
 import org.eclipse.ui.IEditorInput;
 
-import net.sourceforge.phpdt.core.ICompilationUnit;
-
 /**
  * Interface for accessing working copies of <code>ICompilationUnit</code>
- * objects. The original compilation unit is only given indirectly by means
- * of an <code>IEditorInput</code>. The life cycle is as follows:
+ * objects. The original compilation unit is only given indirectly by means of
+ * an <code>IEditorInput</code>. The life cycle is as follows:
  * <ul>
- * <li> <code>connect</code> creates and remembers a working copy of the 
- *   compilation unit which is encoded in the given editor input</li>
- * <li> <code>getWorkingCopy</code> returns the working copy remembered on 
- *   <code>connect</code></li>
- * <li> <code>disconnect</code> destroys the working copy remembered on 
- *   <code>connect</code></li>
+ * <li> <code>connect</code> creates and remembers a working copy of the
+ * compilation unit which is encoded in the given editor input</li>
+ * <li> <code>getWorkingCopy</code> returns the working copy remembered on
+ * <code>connect</code></li>
+ * <li> <code>disconnect</code> destroys the working copy remembered on
+ * <code>connect</code></li>
  * </ul>
  * <p>
  * This interface is not intended to be implemented by clients.
  * </p>
- *
+ * 
  * @see JavaUI#getWorkingCopyManager
  */
 public interface IWorkingCopyManager {
-       
+
        /**
-        * Connects the given editor input to this manager. After calling
-        * this method, a working copy will be available for the compilation unit encoded
-        * in the given editor input (does nothing if there is no encoded compilation unit).
-        *
-        * @param input the editor input
-        * @exception CoreException if the working copy cannot be created for the 
-        *   compilation unit
+        * Connects the given editor input to this manager. After calling this
+        * method, a working copy will be available for the compilation unit encoded
+        * in the given editor input (does nothing if there is no encoded
+        * compilation unit).
+        * 
+        * @param input
+        *            the editor input
+        * @exception CoreException
+        *                if the working copy cannot be created for the compilation
+        *                unit
         */
        void connect(IEditorInput input) throws CoreException;
-       
+
        /**
-        * Disconnects the given editor input from this manager. After calling
-        * this method, a working copy for the compilation unit encoded
-        * in the given editor input will no longer be available. Does nothing if there
-        * is no encoded compilation unit, or if there is no remembered working copy for
+        * Disconnects the given editor input from this manager. After calling this
+        * method, a working copy for the compilation unit encoded in the given
+        * editor input will no longer be available. Does nothing if there is no
+        * encoded compilation unit, or if there is no remembered working copy for
         * the compilation unit.
         * 
-        * @param input the editor input
+        * @param input
+        *            the editor input
         */
        void disconnect(IEditorInput input);
-       
+
        /**
-        * Returns the working copy remembered for the compilation unit encoded in the
-        * given editor input.
-        *
-        * @param input the editor input
-        * @return the working copy of the compilation unit, or <code>null</code> if the
-        *   input does not encode an editor input, or if there is no remembered working
-        *   copy for this compilation unit
+        * Returns the working copy remembered for the compilation unit encoded in
+        * the given editor input.
+        * 
+        * @param input
+        *            the editor input
+        * @return the working copy of the compilation unit, or <code>null</code>
+        *         if the input does not encode an editor input, or if there is no
+        *         remembered working copy for this compilation unit
         */
        ICompilationUnit getWorkingCopy(IEditorInput input);
-       
+
        /**
         * Shuts down this working copy manager. All working copies still remembered
         * by this manager are destroyed.