Fix the short option for 'no-warning-for-unkeyed-lists'

[yangtools.git] / common / concepts / src / main / java / org / opendaylight / yangtools / concepts / Builder.java

diff --git a/common/concepts/src/main/java/org/opendaylight/yangtools/concepts/Builder.java b/common/concepts/src/main/java/org/opendaylight/yangtools/concepts/Builder.java
index e33eca895665bf15b2bbf8922fababb07caf3e94..feec797b0711aa40a8d173e8ae9c858ad84f19f8 100644 (file)
--- a/common/concepts/src/main/java/org/opendaylight/yangtools/concepts/Builder.java
+++ b/common/concepts/src/main/java/org/opendaylight/yangtools/concepts/Builder.java
@@ -11,16 +11,12 @@ package org.opendaylight.yangtools.concepts;
  * Builder object which produces a product.
  *
  * @param <P> Product of builder
- *
  * @author Tony Tkacik &lt;ttkacik@cisco.com&gt;
+ * @deprecated This is an over-arching concept whose {@link #build()} method hides caller hierarchy. Users are advised
+ *             to migrate away, either without a replacement interface, or with a proper domain-specific interface.
  */
-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 has changed.
-     *
-     * @return A newly-built instance
-     * @throws IllegalStateException if the builder's state is not sufficiently initialized
-     */
+@Deprecated(since = "8.0.0", forRemoval = true)
+public interface Builder<P> extends CheckedBuilder<P, IllegalArgumentException> {
+    @Override
     P build();
 }