Re: [netmod] Last Call: <draft-ietf-netmod-artwork-folding-07.txt> (Handling Long Lines in Inclusions in Internet-Drafts and RFCs) to Best Current Practice

Kent Watsen <kent@watsen.net> Wed, 31 July 2019 19:41 UTC

Return-Path: <0100016c498d2a40-f6b9bf13-15c9-4d20-9be2-bea7147d60e5-000000@amazonses.watsen.net>
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 549461200E5; Wed, 31 Jul 2019 12:41:27 -0700 (PDT)
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, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_NONE=0.001] autolearn=ham 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 DP9OZw5tBXwe; Wed, 31 Jul 2019 12:41:25 -0700 (PDT)
Received: from a8-64.smtp-out.amazonses.com (a8-64.smtp-out.amazonses.com [54.240.8.64]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 3F853120018; Wed, 31 Jul 2019 12:41:25 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=6gbrjpgwjskckoa6a5zn6fwqkn67xbtw; d=amazonses.com; t=1564602084; h=From:Message-Id:Content-Type:Mime-Version:Subject:Date:In-Reply-To:Cc:To:References:Feedback-ID; bh=7ftrCj6MlC3Gf7eW1XkIbfgoFwGR89/zGxQihmNWrAo=; b=lthOuMKIIGFCfvUDkdXyjhFt0BYZfP/+QC2IQ6JrgXAhkwA1OHkCm5t5VislQ+ng bgEMOBVGK2TLUw9bPvJev9HOZNLm47zZ1xYHbXTR1VFd93SOg820UdIEkJA0dAc5FZ/ 1kjJzzFiuwr1ZMEGJZZ0jNKAOYa51gPRCWOUEtmk=
From: Kent Watsen <kent@watsen.net>
Message-ID: <0100016c498d2a40-f6b9bf13-15c9-4d20-9be2-bea7147d60e5-000000@email.amazonses.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_EC3B07A6-794B-4565-86E3-5C88A8F42FB9"
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.11\))
Date: Wed, 31 Jul 2019 19:41:24 +0000
In-Reply-To: <1e399e65-4cc9-1e46-018f-5d6427e953c9@alum.mit.edu>
Cc: IETF discussion list <ietf@ietf.org>, Ignas Bagdonas <ibagdona@gmail.com>, "netmod-chairs@ietf.org" <netmod-chairs@ietf.org>, draft-ietf-netmod-artwork-folding@ietf.org, "netmod@ietf.org" <netmod@ietf.org>
To: Paul Kyzivat <pkyzivat@alum.mit.edu>
References: <156451937390.14101.5438428659513611953.idtracker@ietfa.amsl.com> <1e399e65-4cc9-1e46-018f-5d6427e953c9@alum.mit.edu>
X-Mailer: Apple Mail (2.3445.104.11)
X-SES-Outgoing: 2019.07.31-54.240.8.64
Feedback-ID: 1.us-east-1.DKmIRZFhhsBhtmFMNikgwZUWVrODEw9qVcPhqJEI2DA=:AmazonSES
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/yETqNHg1MfajVUg00f3_EWLPwls>
Subject: Re: [netmod] Last Call: <draft-ietf-netmod-artwork-folding-07.txt> (Handling Long Lines in Inclusions in Internet-Drafts and RFCs) to Best Current Practice
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, 31 Jul 2019 19:41:28 -0000

Hi Paul,

Thanks for your comments!


> 1) Section 6.2 recommends only using double backslash folding if single backslash folding doesn't work. But all the examples in section 9 violate this.

True, but these example illustrate the algorithm itself, and so seem okay, or is your suggestion to add text stating this?

FWIW, the `rfcfold` script in the appendix of the draft was used on all the examples in Section 9.  By default, the `rfcfold` script follows the recommendation (i.e., single before double), but also accepts a command-line option to specify the folding strategy to use.  For the examples in section 9, this command-line option  was used.


> 2) Regarding forced folding in section 8.2.1: step 1 (Determine where the fold will occur) could benefit from some elaboration regarding lines that require forced folding. In particular, when an input line flagged for forced folding ends in backslash, then it must indeed be folded before the last character, while in all other cases it can be folded at any position prior to the max line length. (While this is obvious if you think about it, some might miss this.)

Your comment goes to step 1, are you suggesting a modification such as the following?

OLD
    1. Determine where the fold will occur. This location MUST be before or at the desired maximum column.

NEW
    1. Determine where the fold will occur. This location MUST be before or at the desired maximum column.  In the case of a forced folding, the location MUST be before or at the end of the line.



> Also, there should be examples of forced folding.

Agreed.


Kent // co-author