IETF Logo Mail Archive

Re: [rfc-i] [xml2rfc] use of sourcecode type

John R Levine <johnl@taugh.com> Tue, 21 July 2020 21:00 UTC

Return-Path: <rfc-interest-bounces@rfc-editor.org>
X-Original-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Delivered-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 6B52E3A0A78; Tue, 21 Jul 2020 14:00:52 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.699
X-Spam-Level:
X-Spam-Status: No, score=-2.699 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.001, MAILING_LIST_MULTI=-1, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=fail (1536-bit key) reason="fail (message has been altered)" header.d=iecc.com header.b=AljTklMG; dkim=fail (1536-bit key) reason="fail (message has been altered)" header.d=taugh.com header.b=h00Ex/rH
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 SdF71wzYoW6w; Tue, 21 Jul 2020 14:00:50 -0700 (PDT)
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 93F5B3A0A6D; Tue, 21 Jul 2020 14:00:50 -0700 (PDT)
Received: from rfcpa.amsl.com (localhost [IPv6:::1]) by rfc-editor.org (Postfix) with ESMTP id 3B5FEF40740; Tue, 21 Jul 2020 14:00:36 -0700 (PDT)
X-Original-To: rfc-interest@rfc-editor.org
Delivered-To: rfc-interest@rfc-editor.org
Received: from localhost (localhost [127.0.0.1]) by rfc-editor.org (Postfix) with ESMTP id 37CD3F40740 for <rfc-interest@rfc-editor.org>; Tue, 21 Jul 2020 14:00:35 -0700 (PDT)
X-Virus-Scanned: amavisd-new at rfc-editor.org
Authentication-Results: rfcpa.amsl.com (amavisd-new); dkim=pass (1536-bit key) header.d=iecc.com header.b=AljTklMG; dkim=pass (1536-bit key) header.d=taugh.com header.b=h00Ex/rH
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 zdcXSzyLZ8qR for <rfc-interest@rfc-editor.org>; Tue, 21 Jul 2020 14:00:31 -0700 (PDT)
Received: from gal.iecc.com (gal.iecc.com [IPv6:2001:470:1f07:1126:0:43:6f73:7461]) by rfc-editor.org (Postfix) with ESMTPS id EDF21F40729 for <rfc-interest@rfc-editor.org>; Tue, 21 Jul 2020 14:00:30 -0700 (PDT)
Received: (qmail 44658 invoked from network); 21 Jul 2020 21:00:41 -0000
DKIM-Signature: v=1; a=rsa-sha256; c=simple; d=iecc.com; h=date:message-id:from:to:subject:mime-version:content-type; s=ae70.5f175779.k2007; i=johnl-iecc.com@submit.iecc.com; bh=siVih4A6MdNEz10UYF0JUJz0hjIDqpsiVv+JPK6zwd4=; b=AljTklMGh6C7uqFy+XyBZiIZncKnwJVU/mXrUs1D1lNPTYiMuSZIKLq2QjqjZCIzdHYtpkskuoPpd3xyMtjobq+aoq1MajAwbd7nGRcC/qg0UJzR8lS69UAUJjLtZN+WVPtRvbIJwKQxWcAb2YAfv9/XHV97NiGlzz/2kN2Ppx9+v8D7Wh3VK1H8ANg7ouL2dFuy2arxTD0/DfJE1DYzX4XrWbS+aJsISQVbKRLdMjgymV9CsS/0LcixSlF177YP
DKIM-Signature: v=1; a=rsa-sha256; c=simple; d=taugh.com; h=date:message-id:from:to:subject:mime-version:content-type; s=ae70.5f175779.k2007; olt=johnl-iecc.com@submit.iecc.com; bh=siVih4A6MdNEz10UYF0JUJz0hjIDqpsiVv+JPK6zwd4=; b=h00Ex/rHYTvKinCDTTrnCUORCsWGeC4tEByBoSFgoo2T9rk8Dugx1WmOH5RJHcKtM5B03tXSiE7jYw5AEqfbaY6UxMttbiyp0SUuo2KNUUqnJtYj8/YtxMtM1INxI33EG35lMBWolk7cbJ8damXNbrPXeCeUz1Qv0AHvUxgyXKY/9jKuRTJ06ptonEolTdG0v9TuG2v7G7l9rK533XMkLxw9suDlfSHB1CRBS7KkajcYr3PyK1NXpAuvLlLRKbSo
Received: from localhost ([IPv6:2001:470:1f07:1126::78:696d:6170]) by imap.iecc.com ([IPv6:2001:470:1f07:1126::78:696d:6170]) with ESMTPSA (TLS1.3 ECDHE-RSA AES-256-GCM AEAD, johnl@iecc.com) via TCP6; 21 Jul 2020 21:00:41 -0000
Date: Tue, 21 Jul 2020 17:00:41 -0400
Message-ID: <b5c5682e-23d4-ba2-2d9e-fcd9d8b382f@taugh.com>
From: John R Levine <johnl@taugh.com>
To: rfc-interest@rfc-editor.org
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="0-537110699-1595365241=:7008"
Subject: Re: [rfc-i] [xml2rfc] use of sourcecode type
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://www.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <http://www.rfc-editor.org/pipermail/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://www.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>

In article <a4c96c4f-72da-e8b6-5a31-b1617bf518fb@alum.mit.edu> you write:
>I agree that we should have some agreed upon way to do this.
>
>Perhaps a "+xyz" suffix, with some agreed up xyz values.

Sure, we can keep a list of conventionally used tags.

>A problem I have with both name and type is that they are invisible in
>the human readable formats. They provide semantic information that may
>be of interest to a reader. Perhaps they could be available in html via
>a popup?

We could do that but it doesn't seem like a very good idea, since there's no popups
in the text or PDF versions.  If the semantics of a code sample are important, the surrounding
text should say something about it.

>> https://www.rfc-editor.org/materials/sourcecode-types.txt
>>
>> (Ha, this doesn’t even have “cddl” in it; I’m not sure how this is updated and whether
>there shouldn’t really be an IANA registry for these.)

This is a local convention with the IETF that goes in the RFC style
guide. IANA registries are for things that interoperate on the global
internet.

R's,
John
_______________________________________________
rfc-interest mailing list
rfc-interest@rfc-editor.org
https://www.rfc-editor.org/mailman/listinfo/rfc-interest

v2.23.0 | Report a Bug | By Email