A massive organize imports and formatting of the sources using default Eclipse code...

[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpdt / core / WorkingCopyOwner.java

diff --git a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/WorkingCopyOwner.java b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/WorkingCopyOwner.java
index e1688f6..4463023 100644 (file)
--- a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/WorkingCopyOwner.java
+++ b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/core/WorkingCopyOwner.java
@@ -14,57 +14,69 @@ import net.sourceforge.phpdt.internal.core.BufferManager;
 import net.sourceforge.phpdt.internal.core.DefaultWorkingCopyOwner;
 
 /**
- * The owner of an <code>ICompilationUnit</code> handle in working copy mode. 
+ * The owner of an <code>ICompilationUnit</code> handle in working copy mode.
  * An owner is used to identify a working copy and to create its buffer.
  * <p>
- * Clients should subclass this class to instantiate a working copy owner that is specific to their need and that
- * they can pass in to various APIs (e.g. <code>IType.resolveType(String, WorkingCopyOwner)</code>.
- * Clients can also override the default implementation of <code>createBuffer(ICompilationUnit)</code>.
- * </p><p>
- * Note: even though this class has no abstract method, which means that it provides functional default behvior,
- * it is still an abstract class, as clients are intended to own their owner implementation.
+ * Clients should subclass this class to instantiate a working copy owner that
+ * is specific to their need and that they can pass in to various APIs (e.g.
+ * <code>IType.resolveType(String, WorkingCopyOwner)</code>. Clients can also
+ * override the default implementation of
+ * <code>createBuffer(ICompilationUnit)</code>.
  * </p>
- * @see ICompilationUnit#becomeWorkingCopy(IProblemRequestor, org.eclipse.core.runtime.IProgressMonitor)
+ * <p>
+ * Note: even though this class has no abstract method, which means that it
+ * provides functional default behvior, it is still an abstract class, as
+ * clients are intended to own their owner implementation.
+ * </p>
+ * 
+ * @see ICompilationUnit#becomeWorkingCopy(IProblemRequestor,
+ *      org.eclipse.core.runtime.IProgressMonitor)
  * @see ICompilationUnit#discardWorkingCopy()
  * @see ICompilationUnit#getWorkingCopy(org.eclipse.core.runtime.IProgressMonitor)
  * @since 3.0
  */
 public abstract class WorkingCopyOwner {
-       
+
        /**
-        * Sets the buffer provider of the primary working copy owner. Note that even if the
-        * buffer provider is a working copy owner, only its <code>createBuffer(ICompilationUnit)</code>
-        * method is used by the primary working copy owner. It doesn't replace the internal primary 
+        * Sets the buffer provider of the primary working copy owner. Note that
+        * even if the buffer provider is a working copy owner, only its
+        * <code>createBuffer(ICompilationUnit)</code> method is used by the
+        * primary working copy owner. It doesn't replace the internal primary
         * working owner.
-        * <p>
-        * This method is for internal use by the jdt-related plug-ins.
-        * Clients outside of the jdt should not reference this method.
+        * <p>
+        * This method is for internal use by the jdt-related plug-ins. Clients
+        * outside of the jdt should not reference this method.
         * </p>
         * 
-        * @param primaryBufferProvider the primary buffer provider
+        * @param primaryBufferProvider
+        *            the primary buffer provider
         */
-       public static void setPrimaryBufferProvider(WorkingCopyOwner primaryBufferProvider) {
+       public static void setPrimaryBufferProvider(
+                       WorkingCopyOwner primaryBufferProvider) {
                DefaultWorkingCopyOwner.PRIMARY.primaryBufferProvider = primaryBufferProvider;
        }
-       
+
        /**
-        * Creates a buffer for the given working copy.
-        * The new buffer will be initialized with the contents of the underlying file
-        * if and only if it was not already initialized by the compilation owner (a buffer is 
+        * Creates a buffer for the given working copy. The new buffer will be
+        * initialized with the contents of the underlying file if and only if it
+        * was not already initialized by the compilation owner (a buffer is
         * uninitialized if its content is <code>null</code>).
         * <p>
-        * Note: This buffer will be associated to the working copy for its entire life-cycle. Another
-        * working copy on same unit but owned by a different owner would not share the same buffer
-        * unless its owner decided to implement such a sharing behaviour.
+        * Note: This buffer will be associated to the working copy for its entire
+        * life-cycle. Another working copy on same unit but owned by a different
+        * owner would not share the same buffer unless its owner decided to
+        * implement such a sharing behaviour.
         * </p>
         * 
-        * @param workingCopy the working copy of the buffer
+        * @param workingCopy
+        *            the working copy of the buffer
         * @return IBuffer the created buffer for the given working copy
         * @see IBuffer
         */
        public IBuffer createBuffer(ICompilationUnit workingCopy) {
 
-               return BufferManager.getDefaultBufferManager().createBuffer(workingCopy);
+               return BufferManager.getDefaultBufferManager()
+                               .createBuffer(workingCopy);
        }
 
 }