module ietf-yang-metadata {
namespace "urn:ietf:params:xml:ns:yang:ietf-yang-metadata";
prefix "md";
organization
"IETF NETMOD (NETCONF Data Modeling Language) Working Group";
contact
"WG Web:
WG List:
WG Chair: Thomas Nadeau
WG Chair: Juergen Schoenwaelder
Editor: Ladislav Lhotka
";
description
"This YANG module defines an extension statement that allows for
defining metadata annotations.
Copyright (c) 2014 IETF Trust and the persons identified as
authors of the code. All rights reserved.
Redistribution and use in source and binary forms, with or
without modification, is permitted pursuant to, and subject to
the license terms contained in, the Simplified BSD License set
forth in Section 4.c of the IETF Trust's Legal Provisions
Relating to IETF Documents
(http://trustee.ietf.org/license-info).
The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL
NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'MAY', and
'OPTIONAL' in the module text are to be interpreted as described
in RFC 2119 (http://tools.ietf.org/html/rfc2119).
This version of this YANG module is part of RFC XXXX
(http://tools.ietf.org/html/rfcXXXX); see the RFC itself for
full legal notices.";
revision 2015-06-09 {
description
"Initial revision.";
reference
"RFC XXXX: Defining and Using Metadata with YANG";
}
extension annotation {
argument name;
description
"This extension allows for defining metadata annotations in
YANG modules. The 'md:annotation' statement can appear only at
the top level of a YANG module.
An annotation defined with this extension statement inherits
the namespace and other context from the YANG module in which
it is defined.
Other properties of the annotation and documentation are
specified using the following standard YANG substatements (all
are optional): 'description', 'if-feature', 'reference',
'status', 'type' and 'units'. If the 'type' statement is not
present, the built-in 'string' type is used by default.
A server announces syntactic support for a particular
annotation by including the module in which the annotation is
defined among the advertised YANG modules (e.g., in NETCONF
hello message).
Semantics and usage rules for an annotation MUST be specified
separately. The 'description' and/or 'reference' statements
SHOULD provide corresponding links.
XML and JSON encoding of annotations is defined in
RFC XXXX.";
}
}