Re: [xml2rfc] [rfc-i] whose on first

Julian Reschke <julian.reschke@gmx.de> Sat, 20 February 2021 07:25 UTC

Return-Path: <julian.reschke@gmx.de>
X-Original-To: xml2rfc@ietfa.amsl.com
Delivered-To: xml2rfc@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id C770F3A08C5 for <xml2rfc@ietfa.amsl.com>; Fri, 19 Feb 2021 23:25:01 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, NICE_REPLY_A=-0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-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=gmx.net
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 CwYvYrRxBHuR for <xml2rfc@ietfa.amsl.com>; Fri, 19 Feb 2021 23:25:00 -0800 (PST)
Received: from mout.gmx.net (mout.gmx.net [212.227.17.20]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 9BD0E3A08BE for <xml2rfc@ietf.org>; Fri, 19 Feb 2021 23:24:59 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1613805889; bh=GayjNDhRrRsb5Fia22x9xhw9goPvONm2fHlJDRSF7LU=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=VPUJcSF1RrcsnlbRX52kbhODh15u4wt3XqSjCgSFtUe44e+WDU8tWtTmnFcGGToyT 0C/8mcIzjTSBsmIVhk+j3318GyZ/87G4/bXbM7fHJ7RQnxQtpWuinqplbIaBmKzLhT 5uSMnsUBMfKwZiQwm5dEjfyQ9DLUOJEGBxpXrBaI=
X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c
Received: from [192.168.178.20] ([91.61.52.60]) by mail.gmx.net (mrgmx104 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MkYXm-1lhRGh3FR0-00m3U4; Sat, 20 Feb 2021 08:24:49 +0100
To: Carsten Bormann <cabo@tzi.org>
Cc: xml2rfc@ietf.org
References: <m2wnv3n1sz.wl-randy@psg.com> <CA975ECC-B70A-4856-8760-443740DB5531@tzi.org> <b34dd0e5-a8a4-9d17-b924-d8f4b73fc6bc@gmx.de> <629EE7CF-70B0-453F-997C-EFF74F995A71@tzi.org>
From: Julian Reschke <julian.reschke@gmx.de>
Message-ID: <5522ffc8-2b20-86a7-0554-055263aab6a7@gmx.de>
Date: Sat, 20 Feb 2021 08:24:48 +0100
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.7.1
MIME-Version: 1.0
In-Reply-To: <629EE7CF-70B0-453F-997C-EFF74F995A71@tzi.org>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: quoted-printable
X-Provags-ID: V03:K1:MAvZ/GlLRLKk7G+IyvRXyhs1bRQG2ZZrMUPT0UM40c8FuTz0US3 GZGfCZvWm0uYao0Rxm4sIr/T3Vv/APhX1ns3lBnWLKmxJMmseCVARwWtCk2e43NGMnaEIPi 0lUwvaLEPbyah3ETSV+DaONlwDjVOF0sEkcXMPbbr9WJGcJcvCXWzQ4ks7FzvpxZCzIindd 2xJjLC77VoMXB1NlRIoKQ==
X-UI-Out-Filterresults: notjunk:1;V03:K0:4kFeTImkGeo=:QuVDgsRu6UfPKT62ErfY3g RGrHtAilGLFGNBnecx4yH275yoKHRusr4H9vfzTO79tHxbjbk5uFM9I7zittt4Cw0RFthwz+L VsMn2adZ9mibOd9Ct9/VxKTKpiT8AvQn9GST/Hl9i5C4VCHynSk2d2junO5Uoj9cCRc1PSY6S 7u7taSZ5zp6RHGM7Xm72PF6wyfCBxrznbHnwiKAHLzDgkkjTFKf1v4M3y41dZW1mtbQKBryKH 3b7I3Pght39E3BNa7xwC5/BK4HjHX+STWGjbaBowlQ8xZPSgxu5FyQjDNpJWF0snX3ChtsyfX s1JTOp9tWhpQJ7N2K3Nz7t9EXtF3KCXleNlk1eCBxRxXWWeMXSZHlxl4p7X+km+Vsp/0BJwyX WXUI1QG4/2jYxQfp/DY32WORNtDzl/Vp3QMF8SptjEpp3Xxj/A40/DwCOB5DBjS1NGwhJe4FS F1jhBXp4L5zN48f2XpTdQMDWND6ubM/JHfxnR6E1k4v12ORl2rluRaoroEtholIE7QemHdHL8 P0pe8VmbRFsOj9GWPXZgYekuJS4OoHxKA000EKjLzRbeY4iiD6zXSlWc+spqk1JP3BT2d8KN+ hhtPToHfoXkf6zG05+TJsJdysIC9zd433SboknYfz7QSNr3QPritC3PnJMAjvETEdZxdsPvgQ OThFtHAJjrEKVIuuB60nISTlHjjMGBKULncPJCn7R0YhC4GmWnQ8RpqPQ/hQFjIq0oWwyJ9kq gAX7rTJ8Gyhw5OouxoEY8Pa8IbaX7mznIUmQw3OCq/rpWZz3Px2tJ8Ie8otN9jC6UnDwi+fst 0n2M4LRPsAk+fU8yQx38N2WyTH6kEC8YrOAWSBIWjghR82WR0C7AnxRWDAAjdcDyx+AtagVDP IDJE4qDpr6BGf65AaafA==
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/cO6jSDobVBP80KdROmpJ6wgmo5M>
Subject: Re: [xml2rfc] [rfc-i] whose on first
X-BeenThere: xml2rfc@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: <xml2rfc.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml2rfc>, <mailto:xml2rfc-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml2rfc/>
List-Post: <mailto:xml2rfc@ietf.org>
List-Help: <mailto:xml2rfc-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml2rfc>, <mailto:xml2rfc-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 20 Feb 2021 07:25:02 -0000

Am 20.02.2021 um 08:08 schrieb Carsten Bormann:
> On 20. Feb 2021, at 07:01, Julian Reschke <julian.reschke@gmx.de> wrote:
>>
>> Note that the <format> element was deprecated in RFC 7991 for good
>> reasons: it had no proper docs, and was inconsistently used. If there's
>> a use case for it, it should be written down properly, and then the
>> element could be resurrected.
>
> Interesting.
> I know of only one usage, and that is quite well established:  Providing multiple link targets that differ in their format.
> Well, it sometimes was used for single links with the intention to give the format of the one target provided.
>
> I find a lot of examples of the single link use in the RFC repository, the most recent one in RFC 8979 from this month.
> RFC 8795 has one with
>            <format type="TXT" target="http://www.ietf.org/internet-drafts/draft-ietf-teas-te-topo-and-tunnel-modeling-06.txt"/>
>            <format type="PDF" target="http://www.ietf.org/internet-drafts/draft-ietf-teas-te-topo-and-tunnel-modeling-06.pdf"/>
>
> What was the usage inconsistent with that?
>
> (I would understand an argument that we don’t know how to render it in general, or that it has an attribute named “octets” :eyeroll:, but not that it was inconsistently used.  Obviously, RFC 7749/7991 was the opportunity to write it down less poorly.)

1) It's (AFAIR) not covered by the style guide.

2) RFC 7749 says in
<https://greenbytes.de/tech/webdav/rfc7749.html#element.format>:

> 2.18. <format>
>
> Provides a link to an additional format variant for a reference.
>
> Note that these additional links are neither used in published RFCs nor supported by all tools. If the goal is to provide a single URI for a reference, the "target" attribute on <reference> can be used instead.
>
> This element appears as a child element of <reference> (Section 2.30).
>
> Content model: this element does not have any contents.

I believe back then it was rendered in HTML but not in text, or the
other way around.

3) If you look at the output formats for 8979 and 8795 you see that the
links indeed are not rendered (I checked text and HTML). I'll also note
that the Internet Draft references point to tools.ietf.org, which likely
is in conflict with the RFC Style Guide.

Best regards, Julian