[yang-doctors] CODE BEGINS to mentions that CODE BEGINS is not used

[Benoit Claise <[e-mail]>]

Dear all,

Here are the hackathon with Joe Clarke, dealing with the yangcatalog.org 
toolchain.

Excerpt from RFC8346.


            B.1.2 <https://tools.ietf.org/html/rfc8346#appendix-B.1.2>.
            OSPF Topology YANG Module

        The OSPF Topology YANG module is specified below.  As mentioned, the
        module is intended as an example for how the Layer 3 Unicast topology
        model can be extended to cover OSPF topologies, but it is not
        normative.  Accordingly, the module is not delimited with
        <CODE BEGINS> and <CODE ENDS> tags.

       file "[e-mail]"
       module example-ospf-topology {
           yang-version 1.1;
           namespace "urn:example:example-ospf-topology";
           prefix "ex-ospft";
           import ietf-yang-types {
               prefix "yang";
           }

Guess what?
The <CODE BEGINS>, which is supposed to say that <CODE BEGINS> is not 
used, actually triggers the extraction

$ xym --strict True  --debug 1 rfc8346.txt

Extracting '[e-mail]'
    Removed 0 empty lines

Extracting '[e-mail]'
    Removed 0 empty lines
    ERROR: 'rfc8346.txt', Line 1425 - YANG file not specified in <CODE 
BEGINS>
    ERROR: 'rfc8346.txt', Line 1428 - YANG module 
'example-ospf-topology' with <CODE BEGINS> and starting with 'example-'

Extracting 'example-ospf-topology'
    Getting YANG file name from module name: example-ospf-topology.yang
    Removed 0 empty lines
    ERROR: 'rfc8346.txt', Line 1963 - Missing <CODE ENDS>
Created the following models that conform to the strict guidelines:
[e-mail]
[e-mail]
example-ospf-topology.yang

Mainly FYI.

Regards, Benoit