SchemaPath has only a few remaining users, with two different concepts
added to cover the two significant use cases. Add pointers to
replacements and deprecate SchemaPath.
JIRA: YANGTOOLS-1238
Change-Id: I21b98fef8112b0773c342fc83356cca9f3b64188
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>
/**
* Represents unique path to the every node inside the module.
/**
* Represents unique path to the every node inside the module.
+ *
+ * @deprecated This path is not really unique, as it does not handle YANG namespace overlap correctly. There are two
+ * different replacements for this class:
+ * <ul>
+ * <li>{@link SchemaNodeIdentifier} for use in
+ * <a href="https://datatracker.ietf.org/doc/html/rfc7950#section-6.5">YANG schema addressing</a>
+ * contexts</li>
+ * <li>{@link EffectiveStatementInference} for use in contexts where the intent is to exchange pointer
+ * to a specific statement. Unlike SchemaPath, though, it does not require additional lookup in most
+ * cases</li>
+ * </ul>
+@Deprecated(since = "7.0.8")
public abstract class SchemaPath implements Immutable {
/**
public abstract class SchemaPath implements Immutable {
/**