Re: [Tools-discuss] bug in XML2RFC

Tom Pusateri <pusateri@bangj.com> Mon, 23 March 2020 01:33 UTC

Return-Path: <pusateri@bangj.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 A2B8B3A095C for <tools-discuss@ietfa.amsl.com>; Sun, 22 Mar 2020 18:33:48 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.1
X-Spam-Level:
X-Spam-Status: No, score=-2.1 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=bangj.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 bTOSAXR7INll for <tools-discuss@ietfa.amsl.com>; Sun, 22 Mar 2020 18:33:36 -0700 (PDT)
Received: from oj.bangj.com (69-77-154-174.static.skybest.com [69.77.154.174]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 420363A08ED for <tools-discuss@ietf.org>; Sun, 22 Mar 2020 18:33:35 -0700 (PDT)
Received: from [172.16.10.175] (mta-107-13-246-59.nc.rr.com [107.13.246.59]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by oj.bangj.com (Postfix) with ESMTPSA id B9B373A32D; Sun, 22 Mar 2020 21:33:28 -0400 (EDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=bangj.com; s=201907; t=1584927208; bh=4fUCKGUYC9I1OTLfLn0RbQwaZQAfMSBhoEXaw0N9aRw=; h=Subject:From:In-Reply-To:Date:Cc:References:To:From; b=OagzsGdbXMgwx5j0VGqD/O3tHhys2FgTpRqsdOsbj+Lt4+2SKUcgRrxHuVKKm7f/8 cdZERjBFwgDUIsYoLfMUu8ZX6d/SP9tiODCYK6MVRSe92hSZf4r5i/IpIPrwznwWEk NuabQSN7EUqDqI5CmNvk5ToSjtVpG6dFd1by9qwMSbAc6UQww0hWZuWxVJZ/wWQ2rQ cqzcnUIckvXovYXSOuhmaJuu3KKoHMr5osxfZ37RhcEO4cSi2hvkXLn2YgtV8lPz4x M55lMcHMHz5Yx0z/9ZIF0IMjJe1A0aUX6QIJtNVGuRFK2PKuNOvhJXhCOfszWSQM8U XfkgEULQpBudQ==
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.0 \(3608.60.0.2.5\))
From: Tom Pusateri <pusateri@bangj.com>
In-Reply-To: <26cb9641-7483-4f26-bbc3-586595825a8d@www.fastmail.com>
Date: Sun, 22 Mar 2020 21:33:27 -0400
Cc: tools-discuss@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <812CDDC5-DA9D-496B-9FD8-0725951A5048@bangj.com>
References: <CADyWQ+Hx=4U0++aX6SbgpHsc8u378jCPdJcZRnVSALN7E+8nmw@mail.gmail.com> <CADyWQ+EASzcHw_gC2=7LtdhhV7kmsVGbJOZh6gRQN-a9r=BTLg@mail.gmail.com> <9F2F694D-0CE0-4EBB-BC7A-CA9BF6F50132@bangj.com> <3E680B06-AC3A-4ABD-95B3-89B82975FA2E@tzi.org> <26cb9641-7483-4f26-bbc3-586595825a8d@www.fastmail.com>
To: Martin Thomson <mt@lowentropy.net>
X-Mailer: Apple Mail (2.3608.60.0.2.5)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/MFotUG-fyVl4Q7gIk_s6hXB_Ol4>
Subject: Re: [Tools-discuss] bug in XML2RFC
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: Mon, 23 Mar 2020 01:33:50 -0000

> On Mar 22, 2020, at 8:18 PM, Martin Thomson <mt@lowentropy.net> wrote:
> 
> On Sat, Mar 21, 2020, at 18:13, Carsten Bormann wrote:
>> I still rely on the HTMLized version, and I think a lot of people do.
> 
> It's a useful baseline. Also, I find the new HTML borderline unreadable.  Mostly that comes down to line length.
> 
> I do prefer HTML, but I am happier with things like https://quicwg.org/base-drafts/draft-ietf-quic-transport.html or https://httpwg.org/http-extensions/draft-ietf-httpbis-header-structure.html or https://mnot.github.io/I-D/how-did-that-get-into-the-repo/

It appears that it is going to be difficult to get general agreement on a new HTML native version.

I do like the QUIC example you list except for the font choice. I find the San Francisco from Apple, Roboto from Google, and then a simple Helvetica provide less eye strain than the multiple font families used in the QUIC example (cabincondensed, lora, oxygenmono).

Another minor issue with the QUIC example is how the Figure labels are too close to the next paragraph.

But I’ve also been frustrated for years with bugs in the HTMLized versions and just want them to go away. This is no criticism of Henrik and any other authors. It’s an impossible task to parse the TXT version and generate HTML.

Tom