X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=blobdiff_plain;f=yang%2Fyang-parser-impl%2Fsrc%2Fmain%2Fjava%2Forg%2Fopendaylight%2Fyangtools%2Fyang%2Fparser%2Fbuilder%2Fapi%2FBuilder.java;h=3e136562f6130f363c27dceedbecd80a4c5768c2;hb=42abb28b99a02f9580f4676ce5c315628e5bcd24;hp=1f1052bb5a07d67deaea7b09048e9e8abbf02bd4;hpb=36368e8e6f9a791c355a7e61010a04e6a4f347d4;p=yangtools.git

diff --git a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/Builder.java b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/Builder.java
index 1f1052bb5a..3e136562f6 100644
--- a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/Builder.java
+++ b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/Builder.java
@@ -8,37 +8,34 @@
 package org.opendaylight.yangtools.yang.parser.builder.api;
 
 import java.util.List;
-
-import org.opendaylight.yangtools.yang.parser.builder.impl.UnknownSchemaNodeBuilder;
+import org.opendaylight.yangtools.concepts.Mutable;
 
 /**
  * Parent interface for all builder interfaces.
+ *
+ * @deprecated Pre-Beryllium implementation, scheduled for removal.
  */
-public interface Builder {
+@Deprecated
+public interface Builder extends Mutable {
 
     /**
-     * Get name of module in which this node is declared.
+     * Returns name of module in which node created by this builder
+     * was declared.
      *
      * @return module name
      */
     String getModuleName();
 
     /**
-     * Set name of module in which this node is declared.
-     *
-     * @param moduleName
-     */
-    void setModuleName(String moduleName);
-
-    /**
-     * Get current line in yang file.
+     * Get current line in yang file, on which statement
+     * associated with this builder was declared.
      *
      * @return current line in yang file
      */
     int getLine();
 
     /**
-     * Get parent node of this node.
+     * Returns parent node builder of this node.
      *
      * @return parent node builder or null if this is top level node
      */
@@ -53,9 +50,13 @@ public interface Builder {
     void setParent(Builder parent);
 
     /**
-     * Add unknown node to this builder.
+     * Adds an unknown node builder to this builder.
+     *
+     * When product (child) is builded by the {@link #build()}
+     * method, this builder is also built and unknown node is added
+     * as child to the product of this builder.
      *
-     * @param unknownNode
+     * @param unknownNode an unknown node builder
      */
     void addUnknownNodeBuilder(UnknownSchemaNodeBuilder unknownNode);