IETF Logo Mail Archive

Re: [Anima] looking for practical advice on managing YANG source in XML format RFCs

Michael Richardson <mcr+ietf@sandelman.ca> Mon, 14 June 2021 14:09 UTC

Return-Path: <mcr+ietf@sandelman.ca>
X-Original-To: anima@ietfa.amsl.com
Delivered-To: anima@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A17CB3A25A4; Mon, 14 Jun 2021 07:09:45 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id M20WMcZ8lxSc; Mon, 14 Jun 2021 07:09:40 -0700 (PDT)
Received: from tuna.sandelman.ca (tuna.sandelman.ca [IPv6:2607:f0b0:f:3:216:3eff:fe7c:d1f3]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 2A6393A259B; Mon, 14 Jun 2021 07:09:39 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by tuna.sandelman.ca (Postfix) with ESMTP id 0708D38C35; Mon, 14 Jun 2021 10:10:44 -0400 (EDT)
Received: from tuna.sandelman.ca ([127.0.0.1]) by localhost (localhost [127.0.0.1]) (amavisd-new, port 10024) with LMTP id wUEbUDVQMhUE; Mon, 14 Jun 2021 10:10:43 -0400 (EDT)
Received: from sandelman.ca (obiwan.sandelman.ca [IPv6:2607:f0b0:f:2::247]) by tuna.sandelman.ca (Postfix) with ESMTP id 83DB738C2D; Mon, 14 Jun 2021 10:10:43 -0400 (EDT)
Received: from localhost (localhost [IPv6:::1]) by sandelman.ca (Postfix) with ESMTP id 2FFDE236; Mon, 14 Jun 2021 10:09:37 -0400 (EDT)
From: Michael Richardson <mcr+ietf@sandelman.ca>
To: Carsten Bormann <cabo@tzi.org>
cc: netmod@ietf.org, tools-discuss@ietf.org, anima@ietf.org
In-Reply-To: <D907A27E-2A70-4292-ADFA-5D8B350E676C@tzi.org>
References: <6795.1623632992@localhost> <D907A27E-2A70-4292-ADFA-5D8B350E676C@tzi.org>
X-Mailer: MH-E 8.6+git; nmh 1.7+dev; GNU Emacs 26.1
X-Face: $\n1pF)h^`}$H>Hk{L"x@)JS7<%Az}5RyS@k9X%29-lHB$Ti.V>2bi.~ehC0; <'$9xN5Ub# z!G,p`nR&p7Fz@^UXIn156S8.~^@MJ*mMsD7=QFeq%AL4m<nPbLgmtKK-5dC@#:k
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-="; micalg="pgp-sha512"; protocol="application/pgp-signature"
Date: Mon, 14 Jun 2021 10:09:37 -0400
Message-ID: <16776.1623679777@localhost>
Archived-At: <https://mailarchive.ietf.org/arch/msg/anima/YquF0SFgJZQgY9f0JCGPCj-8HIo>
Subject: Re: [Anima] looking for practical advice on managing YANG source in XML format RFCs
X-BeenThere: anima@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Autonomic Networking Integrated Model and Approach <anima.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/anima>, <mailto:anima-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/anima/>
List-Post: <mailto:anima@ietf.org>
List-Help: <mailto:anima-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/anima>, <mailto:anima-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 14 Jun 2021 14:09:46 -0000

Carsten Bormann <cabo@tzi.org> wrote:
    > On 14. Jun 2021, at 03:09, Michael Richardson <mcr+ietf@sandelman.ca> wrote:
    >>
    >> 1) how to process yang files with YYYY-DD-MM into XML.
    >> 2) how to generate yang tree files.
    >> 3) how do I get my YANG includes downloaded, and do I put them into my repo?
    >> 4) how to do this with MT Makefiles?

    > I people could tell me what they need, we could develop a feature in
    > kramdown-rfc to handle this.

One possibility is that kramdown-rfc ought to look for, and include the
latest foo-YYYY-MM-DD.yang file, when told to ::include foo.yang.
Alternatively, it could perhaps do the YYYY-MM-DD substitution itself.

    > (This would presumably also include support for YANG-SID files.)

That's mostly just a question about including the results, and it's not that
hard thing to add to the main Makefile.

But, as I said, I xml2rfc doesn't have a useful include functionality, for
when not working with kramdown.

--
Michael Richardson <mcr+IETF@sandelman.ca>   . o O ( IPv6 IøT consulting )
           Sandelman Software Works Inc, Ottawa and Worldwide

v2.23.0 | Report a Bug | By Email