BUG-865: deprecate pre-Beryllium parser elements

[yangtools.git] / yang / yang-parser-impl / src / main / java / org / opendaylight / yangtools / yang / parser / builder / api / ConstraintsBuilder.java

diff --git a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/ConstraintsBuilder.java b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/ConstraintsBuilder.java
index e122e5978fbec50546e5f57df7461c4ae21d65b2..4d1cd8961bf34ee3af61ed3371b2981c24e7628a 100644 (file)
--- a/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/ConstraintsBuilder.java
+++ b/yang/yang-parser-impl/src/main/java/org/opendaylight/yangtools/yang/parser/builder/api/ConstraintsBuilder.java
@@ -1,5 +1,6 @@
 /*
- * Copyright (c) 2013 Cisco Systems, Inc. and others. All rights reserved.
+ * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
+ *
  * This program and the accompanying materials are made available under the
  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
  * and is available at http://www.eclipse.org/legal/epl-v10.html
@@ -11,6 +12,10 @@ import org.opendaylight.yangtools.concepts.Builder;
 import org.opendaylight.yangtools.yang.model.api.ConstraintDefinition;
 import org.opendaylight.yangtools.yang.model.api.MustDefinition;
 
+/**
+ * @deprecated Pre-Beryllium implementation, scheduled for removal.
+ */
+@Deprecated
 public interface ConstraintsBuilder extends Builder<ConstraintDefinition> {
 
     /**
@@ -112,7 +117,7 @@ public interface ConstraintsBuilder extends Builder<ConstraintDefinition> {
     /**
      * Sets mandatory status of parent node
      *
-     * @param mandatory
+     * @param mandatory mandatory status
      */
     void setMandatory(boolean mandatory);
 
@@ -120,7 +125,9 @@ public interface ConstraintsBuilder extends Builder<ConstraintDefinition> {
      * Build constraint definition
      *
      * @return instance of ConstraintDefinition created from this builder
+     *
+     * @deprecated Use {@link #build()} instead
      */
+    @Deprecated
     ConstraintDefinition toInstance();
-
 }
\ No newline at end of file