BUG-865: deprecate pre-Beryllium parser elements

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

diff --git a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/UsesNodeBuilder.java b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/UsesNodeBuilder.java
index f24e1695d8a72cd30d39069f598e8b02bd70b675..aedeef3ccbb47ecfc43498171d5d31655906f12d 100644 (file)
--- a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/UsesNodeBuilder.java
+++ b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/UsesNodeBuilder.java
@@ -15,7 +15,10 @@ import org.opendaylight.yangtools.yang.model.api.UsesNode;
 
 /**
  * Builder for  'uses' statement.
+ *
+ * @deprecated Pre-Beryllium implementation, scheduled for removal.
  */
+@Deprecated
 public interface UsesNodeBuilder extends GroupingMember {
 
     /**
@@ -27,11 +30,11 @@ public interface UsesNodeBuilder extends GroupingMember {
     DataNodeContainerBuilder getParent();
 
     /**
-     * Get grouping path as string.
+     * Get target grouping path.
      *
-     * @return grouping path as String
+     * @return target grouping path
      */
-    String getGroupingPathAsString();
+    SchemaPath getTargetGroupingPath();
 
     /**
      * Get grouping path.
@@ -81,7 +84,7 @@ public interface UsesNodeBuilder extends GroupingMember {
     /**
      * Set information if this uses node is defined in augment.
      *
-     * @param augmenting
+     * @param augmenting information about augmentation
      */
     void setAugmenting(boolean augmenting);
 
@@ -155,6 +158,8 @@ public interface UsesNodeBuilder extends GroupingMember {
      *
      * @deprecated Do not use this, this should be internal to the implementation
      *  and public API contract.
+     *
+     *  @param resolved resolved
      */
     @Deprecated
     void setResolved(boolean resolved);