DeclaredStatements can contain default implementations
[yangtools.git] / yang / yang-model-api / src / main / java / org / opendaylight / yangtools / yang / model / api / stmt / DocumentationGroup.java
1 /*
2  * Copyright (c) 2015 Cisco Systems, Inc. and others.  All rights reserved.
3  *
4  * This program and the accompanying materials are made available under the
5  * terms of the Eclipse Public License v1.0 which accompanies this distribution,
6  * and is available at http://www.eclipse.org/legal/epl-v10.html
7  */
8 package org.opendaylight.yangtools.yang.model.api.stmt;
9
10 import javax.annotation.Nullable;
11
12 /**
13  * Common interface for statements which contain either a description/reference or a description/reference/status combo.
14  *
15  * @deprecated Use {@link DocumentedDeclaredStatement} instead.
16  */
17 @Deprecated
18 public interface DocumentationGroup {
19     /**
20      * Return description statement, if available.
21      *
22      * @return description statement
23      */
24     @Nullable DescriptionStatement getDescription();
25
26     /**
27      * Return description statement, if available.
28      *
29      * @return description statement
30      */
31     @Nullable ReferenceStatement getReference();
32
33     interface WithStatus extends DocumentationGroup {
34
35         @Nullable StatusStatement getStatus();
36     }
37 }