Re: [netmod] I-D Action: draft-ietf-netmod-artwork-folding-06.txt

Kent Watsen <kent@watsen.net> Thu, 27 June 2019 21:35 UTC

Return-Path: <0100016b9add6136-2ad41038-eda3-4ebf-953f-187290bd678a-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 8462A120168 for <netmod@ietfa.amsl.com>; Thu, 27 Jun 2019 14:35:31 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.896
X-Spam-Level:
X-Spam-Status: No, score=-1.896 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, URIBL_BLOCKED=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 RJoQO1dEwg_o for <netmod@ietfa.amsl.com>; Thu, 27 Jun 2019 14:35:29 -0700 (PDT)
Received: from a8-33.smtp-out.amazonses.com (a8-33.smtp-out.amazonses.com [54.240.8.33]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 4FDD1120105 for <netmod@ietf.org>; Thu, 27 Jun 2019 14:35:29 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/simple; s=6gbrjpgwjskckoa6a5zn6fwqkn67xbtw; d=amazonses.com; t=1561671328; h=From:Content-Type:Mime-Version:Subject:Date:References:To:In-Reply-To:Message-Id:Feedback-ID; bh=drTKrZSYmjKgE+dSLghFHSRe/e0qQlfsREJ/onqglLc=; b=Tkm0D43cfSIwB+TZbmyOvJwnEGQCeTnkqhC8C2p9yErUItLZsbSYVre+j4o+pQ53 9kqHg/bMvPFX6/EQw21p88PFhDy5Zuo5h8CQG96jTszjcHqpjruJP9wPouzZd9xr5lT QZVEth73Vvnjpn9x5IIdlcnFkgK2PKtg2reYRWmE=
From: Kent Watsen <kent@watsen.net>
Content-Type: multipart/alternative; boundary="Apple-Mail=_9142C9BB-DFD4-4734-BE8E-A9FDE4F6CDB2"
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.11\))
Date: Thu, 27 Jun 2019 21:35:28 +0000
References: <156167042338.21715.14230991158020374795@ietfa.amsl.com>
To: "netmod@ietf.org" <netmod@ietf.org>
In-Reply-To: <156167042338.21715.14230991158020374795@ietfa.amsl.com>
Message-ID: <0100016b9add6136-2ad41038-eda3-4ebf-953f-187290bd678a-000000@email.amazonses.com>
X-Mailer: Apple Mail (2.3445.104.11)
X-SES-Outgoing: 2019.06.27-54.240.8.33
Feedback-ID: 1.us-east-1.DKmIRZFhhsBhtmFMNikgwZUWVrODEw9qVcPhqJEI2DA=:AmazonSES
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/Kx3cbBEj96vRisUwmU9zKa7zWXw>
Subject: Re: [netmod] I-D Action: draft-ietf-netmod-artwork-folding-06.txt
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: Thu, 27 Jun 2019 21:35:32 -0000

This update primarily regards the non-normative script:

    - renamed to "rfcfold"
    - now only uses sed one-liners
    - auto-detects if platforms `[g]sed` and `pcregrep` are present and
       suitable, outputting an error message if not.
    - cleans up the temporary directory if exits for any reason
    - improved error message around the script not implementing the
      force-fold logic.

    Special thanks to Eric Auerswald for supplying the pull requests 
    for much of the above!


Outside the updates to the script:

    - renamed 9.3:
          OLD: Example Showing Smart Folding
          NEW: Example Showing "Smart" Folding

    - renamed Appendix A:
          OLD: POSIX Shell Script: rfcfold
          NEW: POSIX Shell Script


My only comments are:

    1) the script itself doesn't name itself "rfcfold" anywhere.
            - albeit, the "name" attribute in the XML is set to "rfcfold".

    2) if the script is expected to be distributed, we may want/need to
        add a copyright statement and/or a pointer to its GitHub repo.


Thanks,
Kent


> On Jun 27, 2019, at 5:20 PM, internet-drafts@ietf.org wrote:
> 
> 
> A New Internet-Draft is available from the on-line Internet-Drafts directories.
> This draft is a work item of the Network Modeling WG of the IETF.
> 
>        Title           : Handling Long Lines in Inclusions in Internet-Drafts and RFCs
>        Authors         : Kent Watsen
>                          Adrian Farrel
>                          Qin Wu
> 	Filename        : draft-ietf-netmod-artwork-folding-06.txt
> 	Pages           : 26
> 	Date            : 2019-06-27
> 
> Abstract:
>   This document defines two strategies for handling long lines in
>   width-bounded text content.  One strategy is based on the historic
>   use of a single backslash ('\') character to indicate where line-
>   folding has occurred, with the continuation occurring with the first
>   non-space (' ') character on the next line.  The second strategy
>   extends the first strategy by adding a second backslash character to
>   identify where the continuation begins and thereby able to handle
>   cases not supported by the first strategy.  Both strategies use a
>   self-describing header enabling automated reconstitution of the
>   original content.
> 
> 
> The IETF datatracker status page for this draft is:
> https://datatracker.ietf.org/doc/draft-ietf-netmod-artwork-folding/
> 
> There are also htmlized versions available at:
> https://tools.ietf.org/html/draft-ietf-netmod-artwork-folding-06
> https://datatracker.ietf.org/doc/html/draft-ietf-netmod-artwork-folding-06
> 
> A diff from the previous version is available at:
> https://www.ietf.org/rfcdiff?url2=draft-ietf-netmod-artwork-folding-06
> 
> 
> Please note that it may take a couple of minutes from the time of submission
> until the htmlized version and diff are available at tools.ietf.org.
> 
> Internet-Drafts are also available by anonymous FTP at:
> ftp://ftp.ietf.org/internet-drafts/
> 
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod