Re: [netmod] [Tools-discuss] reflow of YANG descriptions, and general YANG format annoyances

Carsten Bormann <cabo@tzi.org> Wed, 11 November 2020 20:02 UTC

Return-Path: <cabo@tzi.org>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 9A1253A0FF5; Wed, 11 Nov 2020 12:02:45 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.897
X-Spam-Level:
X-Spam-Status: No, score=-1.897 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, 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 kPlL5_1xNG8c; Wed, 11 Nov 2020 12:02:43 -0800 (PST)
Received: from gabriel-vm-2.zfn.uni-bremen.de (gabriel-vm-2.zfn.uni-bremen.de [134.102.50.17]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A80D63A1220; Wed, 11 Nov 2020 12:01:47 -0800 (PST)
Received: from [192.168.217.118] (p548dcc60.dip0.t-ipconnect.de [84.141.204.96]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-vm-2.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4CWbGd4hTJzySb; Wed, 11 Nov 2020 21:01:45 +0100 (CET)
Content-Type: text/plain; charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.4\))
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <01000175b8a8c97a-da2bdc7c-435a-425d-9b45-8eeb581bdeea-000000@email.amazonses.com>
Date: Wed, 11 Nov 2020 21:01:45 +0100
Cc: Ladislav Lhotka <ladislav.lhotka@nic.cz>, "tools-discuss@ietf.org" <tools-discuss@ietf.org>, tom petch <ietfc@btconnect.com>, "netmod@ietf.org" <netmod@ietf.org>, William Lupton <wlupton@broadband-forum.org>
X-Mao-Original-Outgoing-Id: 626817705.134884-b0d1cfd738be0c102a928bfa8261d995
Content-Transfer-Encoding: quoted-printable
Message-Id: <48F05081-414D-4EEE-9BA7-FA7B2F5B19EE@tzi.org>
References: <29950.1604697852@localhost> <008B882D-102D-4AEA-AF59-E259F07089CB@tzi.org> <6712.1604707568@localhost> <4BC302A5-D990-45EE-85C2-196BBC1D09DF@tzi.org> <CAEe_xxhNEPuMhg0i14J=0+hW-3+NgknEDG99qyMRdR59q8OM_Q@mail.gmail.com> <AM7PR07MB624894667774FE0C7C94DCD1A0E90@AM7PR07MB6248.eurprd07.prod.outlook.com> <87tutwj906.fsf@nic.cz> <01000175b8a8c97a-da2bdc7c-435a-425d-9b45-8eeb581bdeea-000000@email.amazonses.com>
To: Kent Watsen <kent@watsen.net>
X-Mailer: Apple Mail (2.3608.120.23.2.4)
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/LQP3n0gtOg-h_I9TdNbb4tV_n8c>
Subject: Re: [netmod] [Tools-discuss] reflow of YANG descriptions, and general YANG format annoyances
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 11 Nov 2020 20:02:46 -0000

On 2020-11-11, at 19:54, Kent Watsen <kent@watsen.net> wrote:
> 
> I don’t understand the "extraction code should not be needed any more” comment, but know that Shepherds and, to a lesser extent, Copy Editors, rely on being able to extract the YANG modules and/or instance examples from the `xml2rfc` XML files.

Once you have the XML for the RFC:
See https://tools.ietf.org/html/rfc8152#page-7
for the right way to do this.

Grüße, Carsten