Pick up byte-buddy from yangtools
[mdsal.git] / binding / yang-binding / src / main / java / org / opendaylight / yangtools / yang / binding / ChoiceIn.java
index 90de8b5571089a685b30add526689f08ae6b1cbc..7f1f59042fe20aaf73a8dab213ec4020368788d3 100644 (file)
@@ -16,22 +16,20 @@ package org.opendaylight.yangtools.yang.binding;
  * This marker interface is also inherited by interfaces generated for {@code case} statements, similarly marking those
  * interfaces as usable within scope when the statement which defined the {@code choice} statement. This allows us to
  * bind {@code grouping}s to their {@code uses} references within an (implicit or explicit) {@code case}, effectively
- * forming an addressing path from {@link DataRoot} or a {@link DataContainer} like this:
+ * forming an addressing path from {@link DataRoot} or a {@link DataContainer}. Given the following generated code:
+ * <pre>{@code
+ *   interface Grouping extends DataObject;
+ *   interface GroupingChild extends ChildOf<Grouping>;
  *
- * <pre>
- * interface Grouping extends DataObject
- * interface GroupingChild extends ChildOf&lt;Grouping&gt;
- *
- * interface Parent extends DataContainer
- * interface Choice implements Choice&lt;Parent&gt;
- * interface Case extends Choice, Grouping
- *
- * Parent -&gt; choiceOf -&gt; Case -&gt; childOf-&gt; GroupingChild
- * </pre>
+ *   interface Parent extends DataContainer;
+ *   interface Choice implements ChoiceIn<Parent>;
+ *   interface Case extends Choice, Grouping;
+ * }</pre>
+ * we can safely make the inference of {@code GroupingChild -> childOf -> Case -> choiceIn -> Parent}.
  *
  * @param <P> Parent container
  * @author Robert Varga
  */
-public interface ChoiceIn<P> extends DataContainer {
+public non-sealed interface ChoiceIn<P> extends DataContainer {
 
 }