BUG-865: deprecate pre-Beryllium parser elements

[yangtools.git] / yang / yang-parser-impl / src / main / java / org / opendaylight / yangtools / yang / parser / builder / api / AugmentationSchemaBuilder.java

diff --git a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/AugmentationSchemaBuilder.java b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/AugmentationSchemaBuilder.java
index f7004791e2c1d21da4fd77970c28438bfdd5f588..c6dcc41f553d5d6248e83c50d6c3eab1e029ec52 100644 (file)
--- a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/AugmentationSchemaBuilder.java
+++ b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/AugmentationSchemaBuilder.java
@@ -12,7 +12,10 @@ import org.opendaylight.yangtools.yang.model.api.SchemaPath;
 
 /**
  * Builder for {@link AugmentationSchema}, which represents 'augment' statement.
+ *
+ * @deprecated Pre-Beryllium implementation, scheduled for removal.
  */
+@Deprecated
 public interface AugmentationSchemaBuilder extends DataNodeContainerBuilder,DocumentedNodeBuilder {
 
     /**
@@ -36,7 +39,7 @@ public interface AugmentationSchemaBuilder extends DataNodeContainerBuilder,Docu
      * for a particular instance, then the node defined by the parent data
      * definition statement is valid; otherwise, it is not.
      *
-     * @param whenCondition
+     * @param whenCondition string representation of when condition
      */
     void addWhenCondition(String whenCondition);
 
@@ -72,7 +75,7 @@ public interface AugmentationSchemaBuilder extends DataNodeContainerBuilder,Docu
     /**
      * Set information about augmentation process.
      *
-     * @param resolved
+     * @param resolved information about augmentation process
      */
     void setResolved(boolean resolved);
 
@@ -85,4 +88,19 @@ public interface AugmentationSchemaBuilder extends DataNodeContainerBuilder,Docu
      */
     int getOrder();
 
+    /**
+     *  Set true if target of augment is unsupported (e.g. node in body of extension).
+     *  In such case, augmentation is skipped and AugmentationSchema is not built.
+     *
+     *  @param unsupportedTarget information about target of augment statement
+     */
+    void setUnsupportedTarget(boolean unsupportedTarget);
+
+    /**
+     *  Return true if target of augment is unsupported (e.g. node in body of extension).
+     *  In such case, augmentation is skipped and AugmentationSchema is not built.
+     *
+     *  @return information about target of augment statement
+     */
+    boolean isUnsupportedTarget();
 }