Expand rfc7950.stmt documentation

Add a few more words on the contents of this package.

Change-Id: Ib3c225f934d9f6ee403ae494070c92da69f8859a
Signed-off-by: Robert Varga <robert.varga@pantheon.tech>

diff --git a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/package-info.java b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/package-info.java
index 5a409a9c3ef57e9319a173a8c36ccd4ee547c0f3..5e7209da101c2d594fefa7f36626d33e7ba31cee 100644 (file)
--- a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/package-info.java
+++ b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/rfc7950/stmt/package-info.java
@@ -15,7 +15,13 @@
  * interactions follow properly-exposed API interfaces.
  *
  * <p>
- * Common base and utility classes for individual statement implementations are maintained in this package.
+ * Common base and utility classes for individual statement implementations are maintained in this package. This package
+ * is not meant for consumption by end users and should be used only by parser extensions.
+ *
+ * <p>
+ * Do not use bare implementation classes exposed from statement sub-packages, as their details are explicitly outside
+ * of API contract. The only exception to this rule are the StatementSupport classes, which allow for correlation and
+ * creation of known YANG statements.
  *
  * @author Robert Varga
  */