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

Michael Richardson <mcr+ietf@sandelman.ca> Sat, 07 November 2020 00:06 UTC

Return-Path: <mcr+ietf@sandelman.ca>
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 446C93A03FC; Fri, 6 Nov 2020 16:06:13 -0800 (PST)
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 G17kgibWB0jm; Fri, 6 Nov 2020 16:06:11 -0800 (PST)
Received: from tuna.sandelman.ca (tuna.sandelman.ca [IPv6:2607:f0b0:f:3:216:3eff:fe7c:d1f3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 195323A03F5; Fri, 6 Nov 2020 16:06:10 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by tuna.sandelman.ca (Postfix) with ESMTP id BBC8338C7C; Fri, 6 Nov 2020 19:06:21 -0500 (EST)
Received: from tuna.sandelman.ca ([127.0.0.1]) by localhost (localhost [127.0.0.1]) (amavisd-new, port 10024) with LMTP id mg6FuKc-HO5g; Fri, 6 Nov 2020 19:06:20 -0500 (EST)
Received: from sandelman.ca (obiwan.sandelman.ca [IPv6:2607:f0b0:f:2::247]) by tuna.sandelman.ca (Postfix) with ESMTP id DEDBC38C78; Fri, 6 Nov 2020 19:06:20 -0500 (EST)
Received: from localhost (localhost [IPv6:::1]) by sandelman.ca (Postfix) with ESMTP id AEE9DE7; Fri, 6 Nov 2020 19:06:08 -0500 (EST)
From: Michael Richardson <mcr+ietf@sandelman.ca>
To: Carsten Bormann <cabo@tzi.org>
cc: tools-discuss@ietf.org, netmod@ietf.org
In-Reply-To: <008B882D-102D-4AEA-AF59-E259F07089CB@tzi.org>
References: <29950.1604697852@localhost> <008B882D-102D-4AEA-AF59-E259F07089CB@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: Fri, 06 Nov 2020 19:06:08 -0500
Message-ID: <6712.1604707568@localhost>
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/KzA9dnMmvBMT4-sIXcgA_Wbq2YM>
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: Sat, 07 Nov 2020 00:06:13 -0000

Carsten Bormann <cabo@tzi.org> wrote:
    > On 2020-11-06, at 22:24, Michael Richardson <mcr+ietf@sandelman.ca> wrote:
    >>
    >> In one of my drafts, I guess some minor wording tweaks in one draft leads to
    >> some lines exceeding 72 characters (by one). Argh. Change from C-mode to
    >> text-mode. reflow.

    > https://www.emacswiki.org/emacs/yang-mode.el
    > https://www.emacswiki.org/emacs/download/yang-mode.el

Yes, turns out I already have used this, but forgot I had it.
I don't see anything that helps.
M-q reflowed a paragraph, but made it too long with 76 columns wide.

And that still doesn't help get the references in the description right.

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