2 * Copyright (c) 2015 Cisco Systems, Inc. and others. All rights reserved.
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
8 package org.opendaylight.yangtools.yang.model.api.stmt;
10 import javax.annotation.Nullable;
12 public interface DocumentationGroup {
15 * All implementations should override this method.
16 * The default definition of this method is used only in YANG 1.0 (RFC6020) implementations of
17 * ImportStatement and IncludeStatement which do not allow a description statement.
18 * These YANG statements have been changed in YANG 1.1 (RFC7950) and can now contain a description statement.
20 * @return description statement
22 // FIXME: version 2.0.0: make this method non-default
23 @Nullable default DescriptionStatement getDescription() {
28 * All implementations should override this method.
29 * The default definition of this method is used only in YANG 1.0 (RFC6020) implementations of
30 * ImportStatement and IncludeStatement which do not allow a reference statement.
31 * These YANG statements have been changed in YANG 1.1 (RFC7950) and can now contain a reference statement.
33 * @return reference statement
35 // FIXME: version 2.0.0: make this method non-default
36 @Nullable default ReferenceStatement getReference() {
40 interface WithStatus extends DocumentationGroup {
42 @Nullable StatusStatement getStatus();