Revert "Migrate concepts to use JDT annotations"
[yangtools.git] / common / concepts / src / main / java / org / opendaylight / yangtools / concepts / Builder.java
index affc25b7713f98c759d06b45ef5c53275074f69f..e33eca895665bf15b2bbf8922fababb07caf3e94 100644 (file)
@@ -9,20 +9,18 @@ package org.opendaylight.yangtools.concepts;
 
 /**
  * Builder object which produces a product.
- * 
+ *
  * @param <P> Product of builder
- * 
- * @author Tony Tkacik <ttkacik@cisco.com>
+ *
+ * @author Tony Tkacik &lt;ttkacik@cisco.com&gt;
  */
 public interface Builder<P> extends Mutable {
-    
     /**
-     * Returns instance of the product.
-     * 
-     * Multiple calls to this method are not required to return
-     * same instance if the state of the builder was changed.
-     * 
-     * @return
+     * Returns instance of the product. Multiple calls to this method are not required to return same instance if
+     * the state of the builder has changed.
+     *
+     * @return A newly-built instance
+     * @throws IllegalStateException if the builder's state is not sufficiently initialized
      */
-    P toInstance();
+    P build();
 }