Re: [xml2rfc-dev] [Ext] Re: [Rfc-markdown] [xml2rfc] <br> is back, was: New xml2rfc release: v2.32.0

Heather Flanagan <rse@rfc-editor.org> Tue, 05 November 2019 19:59 UTC

Return-Path: <rse@rfc-editor.org>
X-Original-To: xml2rfc-dev@ietfa.amsl.com
Delivered-To: xml2rfc-dev@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 122AD1200A4 for <xml2rfc-dev@ietfa.amsl.com>; Tue, 5 Nov 2019 11:59:39 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.2
X-Spam-Level:
X-Spam-Status: No, score=-4.2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, 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 mHxJxSvSKR4T for <xml2rfc-dev@ietfa.amsl.com>; Tue, 5 Nov 2019 11:59:35 -0800 (PST)
Received: from rfc-editor.org (rfc-editor.org [4.31.198.49]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 073111208AB for <xml2rfc-dev@ietf.org>; Tue, 5 Nov 2019 11:59:16 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by rfc-editor.org (Postfix) with ESMTP id 40571F40710; Tue, 5 Nov 2019 11:58:59 -0800 (PST)
X-Virus-Scanned: amavisd-new at rfc-editor.org
Received: from rfc-editor.org ([127.0.0.1]) by localhost (rfcpa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id fPwYYi2hswh2; Tue, 5 Nov 2019 11:58:58 -0800 (PST)
Received: from [IPv6:2620:f:8000:210:5027:52eb:90d1:4e61] (unknown [IPv6:2620:f:8000:210:5027:52eb:90d1:4e61]) by rfc-editor.org (Postfix) with ESMTPSA id 2673FF406D3; Tue, 5 Nov 2019 11:58:57 -0800 (PST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 13.0 \(3601.0.10\))
From: Heather Flanagan <rse@rfc-editor.org>
In-Reply-To: <ba571a31-5853-cb2e-4ed1-2efabdff2470@gmx.de>
Date: Tue, 05 Nov 2019 14:59:11 -0500
Cc: Henrik Levkowetz <henrik@levkowetz.com>, "xml2rfc-dev@ietf.org" <xml2rfc-dev@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <345F3DA7-A0A6-4C45-A30E-FF09CA6E76AE@rfc-editor.org>
References: <E1iGMu9-00055y-Ui@durif.tools.ietf.org> <efb58534-8112-2303-1967-536daae9ff51@gmx.de> <34FFD9FB-7D0A-4BEE-9BAD-AFBD7F883CE6@amsl.com> <d53ef90e-5a50-1472-a61e-12c7a417ac44@icann.org> <b19cd7de-6992-a3b5-ea23-929627018cc0@gmx.de> <019a4a58-ca92-0497-1155-303fba341241@gmx.de> <FB3B5D3A-2AFF-4ACE-BD71-D9EE2F9A4908@tzi.org> <4911a729-648a-a6c7-e673-4dd0fc0cadac@levkowetz.com> <908decb8-c24c-238d-2e27-982aa587d321@gmx.de> <0f5b5e73-bcca-0ff5-570d-c1622891dcf8@gmx.de> <703F1E91-C9E0-42BD-927C-D0D65D8CF7B0@rfc-editor.org> <6723154e-9bf1-d8ce-c8bd-a681fec1de5a@gmx.de> <D1535E4D-A260-477E-AF44-720C28801768@rfc-editor.org> <c551753e-7b28-0284-3ef8-bba884ea44f2@gmx.de> <6EAF86F8-C32F-434E-87ED-9E66043CC989@rfc-editor.org> <6c67abbc-542d-f734-d462-658ae8ad0820@levkowetz.com> <a6da4e7f-d82b-8c65-9ff6-477fd0d475bf@gmx.de> <B55B4594-3381-44D8-AE88-57453C418DA5@rfc-editor.org> <951cb208-e942-6b60-ce51-3629a4320e5b@gmx.de> <4B6CDE05-0712-4287-B9DB-953169D2C218@rfc-editor.org> <ba571a31-5853-cb2e-4ed1-2efabdff2470@gmx.de>
To: Julian Reschke <julian.reschke@gmx.de>
X-Mailer: Apple Mail (2.3601.0.10)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc-dev/fxXV0yYquMm2Td6MlgZBwMuUCK4>
Subject: Re: [xml2rfc-dev] [Ext] Re: [Rfc-markdown] [xml2rfc] <br> is back, was: New xml2rfc release: v2.32.0
X-BeenThere: xml2rfc-dev@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussion about particulars of xml2rfc V3 design, development and code." <xml2rfc-dev.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc-dev/>
List-Post: <mailto:xml2rfc-dev@ietf.org>
List-Help: <mailto:xml2rfc-dev-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc-dev>, <mailto:xml2rfc-dev-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 05 Nov 2019 19:59:39 -0000


> On Nov 5, 2019, at 2:47 PM, Julian Reschke <julian.reschke@gmx.de> wrote:
> 
> On 05.11.2019 20:37, Heather Flanagan wrote:
>> 
>> 
>>> On Nov 5, 2019, at 2:30 PM, Julian Reschke <julian.reschke@gmx.de> wrote:
>>> 
>>> On 05.11.2019 19:55, Heather Flanagan wrote:
>>>> ...
>>>> 
>>>> Matching what you see aside, do you have any concerns with my requirements?
>>>> 
>>>> Heather
>>> 
>>> Yes, of course.
>> 
>> To be clear, for my own sanity:
>> 
>> Yes, of course you have concerns with the functional requirement I described, or
> 
> You said that "<br/>" should be ignored when the document/section title
> is referenced. I believe that's wrong; it should be treated as whitespace.

OK. I’m assuming it’s an implementation detail to make sure we don’t end up with double spaces, then?

> 
>> Yes, of course you have concerns with how the requirement is technically implemented?
> 
> Well, xml2rfc currently does not implement <br>, but is does implement
> the unicode line break character
> (<https://www.fileformat.info/info/unicode/char/2028/index.htm>). *That*
> implementation carries over the line break into the ToC, and I believe
> that's wrong, and it also does not seem to be what you want. (I did not
> check what happens with <xref> or <reference>, but I can check that if
> that's of interest).

It’s something fixable. I expect Henrik is working on it.

> 
>> ...
>> How <br> is implemented in the different outputs is going to be contingent on the requirements of that format and what is considered valid. So, of course we want valid HTML. Whether that means a transformation from what the XML says into what the HTML requires is an implementation I don’t have an opinion on. My job is to offer the functional requirements, not tell the developer how to do the job.
>> ...
> 
> I agree with that, but I note that RFC 7992 tried to actually do that :-).

We’re trying to do a lot of things. 

-Heather