From: Robert Varga <rovarga@cisco.com>
Date: Sun, 4 Oct 2015 05:14:55 +0000 (+0200)
Subject: Deprecate InstanceIdentifierTypeDefinition.getRevisionAwareXPath()
X-Git-Tag: release/beryllium~214
X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?a=commitdiff_plain;h=f68ad38abee919ad9da200637318d4a813d39955;p=yangtools.git

Deprecate InstanceIdentifierTypeDefinition.getRevisionAwareXPath()

This method has been added due to mis-reading of RFC6020. YANG actually
does not define this property, but rather specifies how
instance-identifier types are to be interpreted.

Change-Id: I484b655475f2817277b62dae5fc7462442ebf874
Signed-off-by: Robert Varga <rovarga@cisco.com>
---

diff --git a/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/type/InstanceIdentifierTypeDefinition.java b/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/type/InstanceIdentifierTypeDefinition.java
index 3d7279655c..e5f80de193 100644
--- a/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/type/InstanceIdentifierTypeDefinition.java
+++ b/yang/yang-model-api/src/main/java/org/opendaylight/yangtools/yang/model/api/type/InstanceIdentifierTypeDefinition.java
@@ -11,27 +11,26 @@ import org.opendaylight.yangtools.yang.model.api.RevisionAwareXPath;
 import org.opendaylight.yangtools.yang.model.api.TypeDefinition;
 
 /**
- * 
  * Contains methods for getting data from the <code>instance-identifier</code>
  * YANG built-in type.
  */
 public interface InstanceIdentifierTypeDefinition extends TypeDefinition<InstanceIdentifierTypeDefinition> {
 
     /**
-     * Returns XPath for instance of
-     * <code>InstanceIdentifierTypeDefinition</code>.
-     * 
+     * Returns XPath for instance of <code>InstanceIdentifierTypeDefinition</code>.
+     *
      * @return instance of type <code>RevisionAwareXPath</code>
+     * @deprecated This method is deprecated because it is not defined in YANG metamodel. It is scheduled for removal
+     *             in Boron release cycle.
      */
+    @Deprecated
     RevisionAwareXPath getPathStatement();
 
     /**
-     * Returns true|false which represents argument of
-     * <code>require-instance</code> statement. This statement is the
+     * Returns true|false which represents argument of <code>require-instance</code> statement. This statement is the
      * substatement of the <code>type</code> statement.
-     * 
-     * @return boolean value which is true if the <code>require-instance</code>
-     *         statement is true and vice versa
+     *
+     * @return boolean value which is true if the <code>require-instance</code> statement is true and vice versa
      */
     boolean requireInstance();
 }