IETF Logo Mail Archive

Re: [Rfc-markdown] [netmod] too long lines from IANA module inclusion

Kent Watsen <kent@watsen.net> Fri, 17 December 2021 17:21 UTC

Return-Path: <0100017dc969ae58-dd8363d6-f0e4-4da1-8291-3a5b16eccb07-000000@amazonses.watsen.net>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id F3BD33A0886; Fri, 17 Dec 2021 09:21:31 -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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=amazonses.com
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 P7GRXUqc7zWb; Fri, 17 Dec 2021 09:21:27 -0800 (PST)
Received: from a8-88.smtp-out.amazonses.com (a8-88.smtp-out.amazonses.com [54.240.8.88]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 93A593A07B7; Fri, 17 Dec 2021 09:21:27 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=ug7nbtf4gccmlpwj322ax3p6ow6yfsug; d=amazonses.com; t=1639761686; h=Content-Type:Mime-Version:Subject:From:In-Reply-To:Date:Cc:Content-Transfer-Encoding:Message-Id:References:To:Feedback-ID; bh=UKrX83+Rhqtx2gF4USR1pLJibTIhyx/kFRZTIz+EhUo=; b=ezLNdcz93XLay5D6/NwNVV9sfih6G2utS7EGj9yv60eipQCSWZ7AmY/VkaFMmZkv HWVXaCImJ6VgqWmlj6ybagUQAKVbMnLj09NGohs9ZBdpITN4PGkC54LdIKNBou4yrIV dQlUfXEA10TwLRUBlaQipNk3YDJk2C5EuoRnNyv4=
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.120.0.1.13\))
From: Kent Watsen <kent@watsen.net>
In-Reply-To: <9B95F768-DA2B-48CA-A66F-F406AECFCE08@tzi.org>
Date: Fri, 17 Dec 2021 17:21:26 +0000
Cc: "netmod@ietf.org" <netmod@ietf.org>, Benoit Claise <benoit.claise=40huawei.com@dmarc.ietf.org>, Slavomír Mazúr <Slavomir.Mazur@pantheon.tech>, Miroslav Kováč <miroslav.kovac@pantheon.tech>, rfc-markdown@ietf.org, Michael Richardson <mcr+ietf@sandelman.ca>, "Eric Vyncke (evyncke)" <evyncke@cisco.com>
Content-Transfer-Encoding: quoted-printable
Message-ID: <0100017dc969ae58-dd8363d6-f0e4-4da1-8291-3a5b16eccb07-000000@email.amazonses.com>
References: <43BBAD20-D816-4D01-8326-1D67185CCC19@tzi.org> <24856.1639347093@localhost> <0100017db6a106f8-a9773885-6347-4fd6-a2d6-69ec6941bc7b-000000@email.amazonses.com> <20211214.083324.1824911592330241723.id@4668.se> <3782772c-b5b4-4285-f65e-67b1113e1b07@huawei.com> <0100017dc8e0fcbd-8899bb50-f0bf-4537-a87b-64eb82d9664a-000000@email.amazonses.com> <FB6407ED-BA9D-415A-AFCB-0D4D327679ED@tzi.org> <0100017dc93be244-843adcee-efda-49d4-9814-fbf91153126b-000000@email.amazonses.com> <9B95F768-DA2B-48CA-A66F-F406AECFCE08@tzi.org>
To: Carsten Bormann <cabo@tzi.org>
X-Mailer: Apple Mail (2.3654.120.0.1.13)
Feedback-ID: 1.us-east-1.DKmIRZFhhsBhtmFMNikgwZUWVrODEw9qVcPhqJEI2DA=:AmazonSES
X-SES-Outgoing: 2021.12.17-54.240.8.88
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/Qus4Ic61-lvmMV_sgAO2tVGeIgI>
Subject: Re: [Rfc-markdown] [netmod] too long lines from IANA module inclusion
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 17 Dec 2021 17:21:32 -0000

Hi Carsten,

>>> Examples from the HTTP ecosystem (GNAP, HTTPAPI, HTTPBIS) didn’t have any “===“ decoration, though.  (Why the heck was this left open as a choice for the author?  I like “%%%” decoration instead, should I use that as a personal fashion statement?)
>> 
>> Because sometimes it is desirable for the bracketing to match the native file commenting syntax (e.g., “#“ for shell/Python, “//“ for C++, “;” for ABNF, etc.)
> 
> But those tools never see that header.
> (Or are there examples where you can safely feed a folded block to a tool?)

Not always.  The draft specifically allows for manual/smart folding to give better results than simple automation:  See https://datatracker.ietf.org/doc/html/rfc8792#section-9.3 for more examples.

K.

v2.23.0 | Report a Bug | By Email