From: Robert Varga <robert.varga@pantheon.tech>
Date: Mon, 22 Jan 2024 22:12:27 +0000 (+0100)
Subject: Add yang.binding.contract documentation
X-Git-Tag: v13.0.1~12
X-Git-Url: https://git.opendaylight.org/gerrit/gitweb?p=mdsal.git;a=commitdiff_plain;h=b9899eb609c72737899032ffdd3e219f0f1eb85e

Add yang.binding.contract documentation

Document the contents of the contract package.

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

diff --git a/binding/yang-binding/src/main/java/module-info.java b/binding/yang-binding/src/main/java/module-info.java
index ba86e6a12f..51ad61fba4 100644
--- a/binding/yang-binding/src/main/java/module-info.java
+++ b/binding/yang-binding/src/main/java/module-info.java
@@ -11,6 +11,8 @@ module org.opendaylight.yangtools.yang.binding {
     exports org.opendaylight.yangtools.yang.binding.contract;
     exports org.opendaylight.yangtools.yang.binding.util;
 
+    requires transitive com.google.common;
+    requires transitive org.opendaylight.yangtools.concepts;
     requires transitive org.opendaylight.yangtools.yang.common;
     requires org.opendaylight.yangtools.util;
 
diff --git a/binding/yang-binding/src/main/java/org/opendaylight/yangtools/yang/binding/contract/package-info.java b/binding/yang-binding/src/main/java/org/opendaylight/yangtools/yang/binding/contract/package-info.java
index 6d19e8c16a..9c73e281a1 100644
--- a/binding/yang-binding/src/main/java/org/opendaylight/yangtools/yang/binding/contract/package-info.java
+++ b/binding/yang-binding/src/main/java/org/opendaylight/yangtools/yang/binding/contract/package-info.java
@@ -5,5 +5,12 @@
  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
  * and is available at http://www.eclipse.org/legal/epl-v10.html
  */
+/**
+ * Various binding contracts. Notable members include
+ * <ul>
+ *   <li>{@link Naming} of classes and methods</li>
+ *   <li>resolution of YANG-to-Java namespace conflicts via {@link StatementNamespace}</li>
+ * </ul>
+ */
 @org.osgi.annotation.bundle.Export
-package org.opendaylight.yangtools.yang.binding.contract;
\ No newline at end of file
+package org.opendaylight.yangtools.yang.binding.contract;