Re: [Tools-discuss] idnits 2.16.02 counts line length using bytes and not characters (but xml2rfc 2.34.0 line-wraps counting chars, not bytes)

Henrik Levkowetz <henrik@levkowetz.com> Tue, 05 November 2019 16:22 UTC

Return-Path: <henrik@levkowetz.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id C559A12022A for <tools-discuss@ietfa.amsl.com>; Tue, 5 Nov 2019 08:22:53 -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 anLY_cCcV_d8 for <tools-discuss@ietfa.amsl.com>; Tue, 5 Nov 2019 08:22:52 -0800 (PST)
Received: from durif.tools.ietf.org (durif.tools.ietf.org [IPv6:2001:1900:3001:11::3d]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id E8C00120124 for <tools-discuss@ietf.org>; Tue, 5 Nov 2019 08:22:51 -0800 (PST)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:52572 helo=tannat.localdomain) by durif.tools.ietf.org with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from <henrik@levkowetz.com>) id 1iS1bX-00045d-CD; Tue, 05 Nov 2019 08:22:51 -0800
To: Daniel Kahn Gillmor <dkg@fifthhorseman.net>, tools-discuss@ietf.org
References: <87h83jpdp1.fsf@fifthhorseman.net> <b045766b-ef0b-7dbd-cf34-b1f2f332c151@levkowetz.com> <87woceo61e.fsf@fifthhorseman.net> <7072e27a-e214-ff30-a6de-93f26796c706@levkowetz.com>
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <d7733101-f5b5-27a1-b7a3-7409c340887a@levkowetz.com>
Date: Tue, 05 Nov 2019 17:22:43 +0100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <7072e27a-e214-ff30-a6de-93f26796c706@levkowetz.com>
Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="ekUA690GWjnua460urlfFqwa7CrxgSLiv"
X-SA-Exim-Connect-IP: 158.174.202.242
X-SA-Exim-Rcpt-To: tools-discuss@ietf.org, dkg@fifthhorseman.net
X-SA-Exim-Mail-From: henrik@levkowetz.com
X-SA-Exim-Version: 4.2.1 (built Mon, 26 Dec 2011 16:24:06 +0000)
X-SA-Exim-Scanned: Yes (on durif.tools.ietf.org)
X-Clacks-Overhead: GNU Terry Pratchett
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/PfdHvnYk71vi6HFakYvY5OGAb9s>
Subject: Re: [Tools-discuss] idnits 2.16.02 counts line length using bytes and not characters (but xml2rfc 2.34.0 line-wraps counting chars, not bytes)
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 05 Nov 2019 16:22:54 -0000

Hi Daniel,

Below:

On 2019-11-05 17:01, Henrik Levkowetz wrote:
> Hi Daniel,
> 
> On 2019-11-05 13:34, Daniel Kahn Gillmor wrote:
>> On Mon 2019-11-04 22:07:00 +0100, Henrik Levkowetz wrote:
>> 
>>> Agreed.  A rewrite of idnits which will do better in this respect is
>>> in progress.
>> 
>> great, thanks!
>> 
>> By the way, the incluson of UTF-8 characters has been really helpful for
>> this specific draft, as it permits pretty diagrams of MIME structure
>> that would be tedious to explain in text, or harder to follow visually
>> if we left out edges between parent and child nodes.
>> 
>> I really appreciate the work that goes into modernizing the IETF toolchain
>> to permit these improvements.
>> 
>> My only regret is that the htmlizer on tools.ietf.org seems to work from
>> the uploaded .txt variant, rather than building the html directly from
>> the .xml source.  "xml2rfc --html --v3" produces a document that is
>> *much* nicer to read (and better structured from an HTML point of view)
>> than the htmlized txt source.
>> 
>> Is there any plan to generate the HTML from the uploaded xml in this way
>> for future documents?
> 
> If you submit v3 XML, HTML is already being generated from the XML.
> 
> Right at the moment, it looks like the net (or wider area?) that
> datatracker.ietf.org lives on is unreachable (I see this for multiple
> machines in the same geographic area) but when it's reachable again,
> you should see a link to the generated html on the datatracker page
> for the document, and you should also find it next to the .txt and
> .xml files in the repository:
> 
>   http://www.ietf.org/id/draft-autocrypt-lamps-protected-headers.html

Mmm.  That lacked the necessary version number, so was incorrect.  I also
see that the XML file is not pure v3, so HTML won't be generated by the
submission tool.

If you run the current XML file through 'xml2rfc --v2v3 ...' you should get
a pure v3 file you can use for future work.


Best regards,

	Henrik