Re: [netmod] Call for adoption request of draft-kwatsen-netmod-artwork-folding-04

Kent Watsen <> Tue, 26 June 2018 19:25 UTC

Return-Path: <>
Received: from localhost (localhost []) by (Postfix) with ESMTP id B64EF131110 for <>; Tue, 26 Jun 2018 12:25:46 -0700 (PDT)
X-Virus-Scanned: amavisd-new at
X-Spam-Flag: NO
X-Spam-Score: -2.701
X-Spam-Status: No, score=-2.701 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: (amavisd-new); dkim=pass (2048-bit key)
Received: from ([]) by localhost ( []) (amavisd-new, port 10024) with ESMTP id p9qe0TcymiGE for <>; Tue, 26 Jun 2018 12:25:44 -0700 (PDT)
Received: from ( []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPS id 8376C13110E for <>; Tue, 26 Jun 2018 12:25:44 -0700 (PDT)
Received: from pps.filterd ( []) by ( with SMTP id w5QJDnDY008265; Tue, 26 Jun 2018 12:25:39 -0700
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-id : content-transfer-encoding : mime-version; s=PPS1017; bh=zrQrB/JXs1+8gLFLYtwEP2N4eZ0jhaXLlFg/+51tMjc=; b=OEz1GnMFqBc+tj35G3WdygqKO8kx2McXqfQ63x3ra+MEyW8gWHMz3ZRAErGsekO6jLl5 pNwmwIaJB+sITxMDyaY/eXjUbSgU3z0I7qIrlDMeZ8DBcBNAhgRFA5uLN+J2tckl5BVu ISzj4ugVlmaWR16l1SVmkK6Z8bY3ue0TcyExXnWdAVSCSt40zE04iplXqA0+4YBzlhXq 9VUbuUgyah9ORwf9jPE2YfN17COCtio1Bgo7baV0tEadjCguE0zrN2uo1Vzh/VG+FOIi WHmdr34K120TLenOxB7Zw8UGBP4crzxCaa5gEAaO8IrO2g/sCpdIC2xkXU9aWsgP8Due /Q==
Received: from ( []) by with ESMTP id 2juq7aggrp-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Tue, 26 Jun 2018 12:25:39 -0700
Received: from ( by ( with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.906.10; Tue, 26 Jun 2018 19:25:37 +0000
Received: from ([fe80::959d:9fbe:90e4:3cc]) by ([fe80::959d:9fbe:90e4:3cc%4]) with mapi id 15.20.0906.018; Tue, 26 Jun 2018 19:25:37 +0000
From: Kent Watsen <>
To: Martin Bjorklund <>
CC: "" <>, "" <>
Thread-Topic: [netmod] Call for adoption request of draft-kwatsen-netmod-artwork-folding-04
Thread-Index: AQHUCpK0us9UwwoDtU2EaBoFZiTowKRyWwQAgAAxxwCAAF1MgP//xKAA
Date: Tue, 26 Jun 2018 19:25:37 +0000
Message-ID: <>
References: <> <> <> <>
In-Reply-To: <>
Accept-Language: en-US
Content-Language: en-US
user-agent: Microsoft-MacOutlook/f.20.0.170309
x-originating-ip: []
x-ms-publictraffictype: Email
x-microsoft-exchange-diagnostics: 1; BYAPR05MB4615; 7:W//aP6o1uMecqQkFqw4TBrhkJi3pPCeYb53zXci9jERfi2YeoUOkrZKcm+UzewIwrDvLvHTfrtG/s9Gr41/9hwvYGtKxbOuZcCL4iqndbIJtZwOIljaBTTMZWquSeJt+QBjbmSH6Hi+o4w4voteXNHCTcIOt/BOY/jCkD+Cz8WgMA//2SIZa7kKs/+GFILels3+9YgOQr9s0D8t5c6GXDuRJXBhzm3i0Yql8nNEapVj7RX/H/2PUCSVYnrwK7KW1
x-ms-exchange-antispam-srfa-diagnostics: SOS;
x-ms-office365-filtering-correlation-id: b027b7f5-cb33-4b4a-ed2b-08d5db9a988a
x-ms-office365-filtering-ht: Tenant
x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(8989117)(4534165)(4627221)(201703031133081)(201702281549075)(8990107)(5600026)(711020)(48565401081)(2017052603328)(7153060)(7193020); SRVR:BYAPR05MB4615;
x-ms-traffictypediagnostic: BYAPR05MB4615:
x-microsoft-antispam-prvs: <>
x-exchange-antispam-report-test: UriScan:;
x-ms-exchange-senderadcheck: 1
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(10201501046)(3002001)(93006095)(93001095)(3231254)(944501410)(52105095)(6055026)(149027)(150027)(6041310)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123562045)(20161123560045)(20161123564045)(20161123558120)(6072148)(201708071742011)(7699016); SRVR:BYAPR05MB4615; BCL:0; PCL:0; RULEID:; SRVR:BYAPR05MB4615;
x-forefront-prvs: 071518EF63
x-forefront-antispam-report: SFV:NSPM; SFS:(10019020)(346002)(136003)(39860400002)(376002)(396003)(366004)(199004)(189003)(51444003)(4326008)(11346002)(6512007)(476003)(2616005)(478600001)(83716003)(486006)(316002)(446003)(66066001)(86362001)(2900100001)(6436002)(99286004)(6916009)(25786009)(6246003)(186003)(36756003)(6116002)(14454004)(5660300001)(26005)(97736004)(6486002)(3846002)(8676002)(102836004)(8936002)(5250100002)(81156014)(82746002)(305945005)(6506007)(105586002)(256004)(2906002)(106356001)(81166006)(7736002)(58126008)(14444005)(93886005)(76176011)(53936002)(54906003)(229853002)(68736007)(33656002); DIR:OUT; SFP:1102; SCL:1; SRVR:BYAPR05MB4615;; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1;
received-spf: None ( does not designate permitted sender hosts)
x-microsoft-antispam-message-info: uUaPPsucWQuW2Pl3Psa4ReKovjAAX4JDDW/xipNqhghyIszZAlAe+hq5Oe4mXKE7ggj1pRILoQkzqOH7y9k5aR7/LFev60ArH/XWOfbrXfDBAFpr+j3go4iZIX3d/meXWUfWQAiWsLhl8XyikiJK3bpmTiFv4On1Rg5guTocaSNpPlhQEQnuIB/ZtKYAZ/mMj/LCNju3TfBPlzGvC96Foa6whTESwlrXUr4ORa2YvmYiV2WGmcq0CPj0LmtL8+7IT2Nk6BJtcS5rWHwrTmpsP7Zo9LgZBpkXGz/sWX38Xtr2DqDp9Ymr5QYVnROKWqTagwUe1jdUi/uEP6hyupj8tcC7alKb1iDOn/r+wdwY8R0=
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: text/plain; charset="utf-8"
Content-ID: <>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: b027b7f5-cb33-4b4a-ed2b-08d5db9a988a
X-MS-Exchange-CrossTenant-originalarrivaltime: 26 Jun 2018 19:25:37.2940 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: bea78b3c-4cdb-4130-854a-1d193232e5f4
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR05MB4615
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2018-06-26_09:, , signatures=0
X-Proofpoint-Spam-Details: rule=outbound_spam_notspam policy=outbound_spam score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1806210000 definitions=main-1806260214
Archived-At: <>
Subject: Re: [netmod] Call for adoption request of draft-kwatsen-netmod-artwork-folding-04
X-Mailman-Version: 2.1.26
Precedence: list
List-Id: NETMOD WG list <>
List-Unsubscribe: <>, <>
List-Archive: <>
List-Post: <>
List-Help: <>
List-Subscribe: <>, <>
X-List-Received-Date: Tue, 26 Jun 2018 19:25:47 -0000

> (The exmaples with just a string of '\' are highy confusing.  Unclear
> what they try to tell me... probably that the alg is much more
> difficult than I originally thought ;-)

Those are torture tests, but they due illustrate the one case where having
the '\\n' on the fold column would've been illegal input (and hence the '\'
was replaced with a 'x').  Great for internal algorithm validation, but
perhaps unnecessary for the example in the text.  Or maybe enhance the
comments above these lines to explain why they're there?

See below for more comments.

>>> I really liked the flexible indentation in the other draft.  I suggest
>>> it is added to this draft.  It enhances readability (if the author
>>> wants it).
>> Variable indentation, when the folded-line starts on same column as
>> the previous line, looks nice.  The current yang-xml-doc-conventions
>> draft has a fixed two-space indent, which would only look nice sometimes 
>> while introducing a surprise factor other times.
> Hmm, I thought it had variable-length indentation.

It was, but removed later, I think from WG comments.   Qin may know more.

>> Variable indent introduces significant complexity; at least, it's beyond
>> what can be accomplished by a `sed` one-liner, such as in the current 
>> draft.  A fixed two-space indent is possible (easy), but zero-space 
>> indent is more common (less surprising) than a fixed indent.
> I like the algorithm in the other draft better - it had variable
> placement of the line break ("\\n" sequence), and variable
> indentation.

How can you automated variable placement of the line-break, assuming no
awareness of the file format?  Additionally, be aware that variable '\n'
placement would necessitate pre-scanning the file to ensure *no* line
ends in a '\\n', as opposed to just the lines that need folding.

> Note that your proposed format is just a special case of the format in
> the other draft, so you can still use your "one-liner" sed to produce
> your result.


>> >>   - handle two special case on backslash and space at the end of broken
>> >>     line in yang-xml-doc-conventions.
>> >>   - propose to use <WRAPPED TEXT BEGIN><WRAPPED TEXT END> to extract
>> >>     artwork from I-Ds.
>> >
>> > The artwork draft proposes only a header, which means that it is not
>> > quite clear where the artwork ends.
>> Interesting point, but I think that artwork-framing is a different problem
>> from artwork-folding.  If the goal is to support extracting artwork from
>> txt-based RFC scripts, regardless if the artwork is folded or not, then we
>> could level-up this draft to that role, while still supporting folding.
>> If we were to add a footer, maybe something like this:
>>   ===padding=== End Folding per BCP XX (RFC XXXX) ===padding===
>> where the "padding" fills in '=' characters until the max-line width is
>> reached (same as how the header is done).
> Ok.

I assume that you're okay-ing the proposed footer, but the real question is
if we should expand the scope of this draft to include artwork-framing also?

>> >> In the artwork draft, section 5.3, you write:
>> >>
>> >>   This line is self-describing in
>> >>   three ways: use of '\' character, identification of BCP/RFC, and
>> >>   identification of what the maximum line length is for the artwork.
>> >>
>> > I was confused about this maximum line length; it seems you define the
>> > maximum line length ot be 53, but that seems too limiting, and indeed
>> > in the example in 5.4 the max line length is 69.  (BTW, the example is
>> > missing in the draft, as is the shell script in Appendix A).   In any
>> > case, I don't see how the header identifies the max line length.
>> The draft says that the *minimal* header string is 53-characters).  We
>> can make it less if needed, but it involves needing to fold the header
>> itself, which could become messy.  Thoughts?
>> Per the line just before the one quoted above, this line is '=' padded
>> on both sides until reaching the max value.  Apparently, this isn't 
>> clear enough in the text, or do you think it's okay now?
> The draft says:
>  The header is two lines long.
>  The first line is the following 53-character string
> This is what made me confused.  I now understand that the idea is to pad
> with '='.

Right, the full sentence is:

   The first line is the following 53-character string that has been
   padded with roughly equal numbers of equal ('=') characters to reach
   the artwork's maximum line length.

So, leave as is for now?

> But if we adopt the algorithm in the other draft, we don't need a
> maximum line length like this.

There still needs to be a maximum line length, whether it's identified
in the header could be discussed.

> /martin