IETF Logo Mail Archive

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

John Levine <johnl@taugh.com> Thu, 23 July 2020 02:46 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 EE3C73A0B70; Wed, 22 Jul 2020 19:46:04 -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=yoMsCzc8; dkim=fail (1536-bit key) reason="fail (message has been altered)" header.d=taugh.com header.b=Ui0Eeqre
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 SfzIbixEVXbf; Wed, 22 Jul 2020 19:46:03 -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 62AEB3A0B6F; Wed, 22 Jul 2020 19:46:03 -0700 (PDT)
Received: from rfcpa.amsl.com (localhost [IPv6:::1]) by rfc-editor.org (Postfix) with ESMTP id D007FF40755; Wed, 22 Jul 2020 19:45:46 -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 C23E9F40755 for <rfc-interest@rfc-editor.org>; Wed, 22 Jul 2020 19:45:44 -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=yoMsCzc8; dkim=pass (1536-bit key) header.d=taugh.com header.b=Ui0Eeqre
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 wNBkISKxZjXi for <rfc-interest@rfc-editor.org>; Wed, 22 Jul 2020 19:45:40 -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 7BA71F4074D for <rfc-interest@rfc-editor.org>; Wed, 22 Jul 2020 19:45:40 -0700 (PDT)
Received: (qmail 55615 invoked from network); 23 Jul 2020 02:45:53 -0000
DKIM-Signature: v=1; a=rsa-sha256; c=simple; d=iecc.com; h=date:message-id:from:to:cc:subject:in-reply-to:mime-version:content-type:content-transfer-encoding; s=d93c.5f18f9e1.k2007; bh=2pWSNAczfspjCK4JtViT3DS8Cj6rSijGL2+XmLvC6k0=; b=yoMsCzc8ZHkFDhtwHnEZJJfSNhjdG0Oik7sJVNRGWTMoo4A0Gz/YJeIsigHW08GxstzklOhk9ypLujfOSKuOJzeAIHSy4jjGGHdUvuixxKCYIB+kpIZhe3ED8T7Yygaz0+iR1c/rqN/mh3XOabtOS9reblEUo+nygRDpd5TcbS5utR3GDag7G2J6aml/OWhoAteNtvIxRjYdgcFoMTl6ufX8M18vXi+8OngfOP7ABuyQ0bYckZM7p0pG2C/dn+JT
DKIM-Signature: v=1; a=rsa-sha256; c=simple; d=taugh.com; h=date:message-id:from:to:cc:subject:in-reply-to:mime-version:content-type:content-transfer-encoding; s=d93c.5f18f9e1.k2007; bh=2pWSNAczfspjCK4JtViT3DS8Cj6rSijGL2+XmLvC6k0=; b=Ui0EeqreVXHgICHFr7Sv84EP0ZMRwaRO48RLhv1gu8jzIwJd503N+S981/vYeocsD6jVjXptl2BNXwF32iP8wDsXGOGV/sl+MbXO84SoIl9LPUWUbIMTK3wNCIsgFO7DHCMlFvA25g50JiVVk8ltXlc70Zj1dO23r9Er5+AR+Qgs5zvOkxvRdqdln68SdJk+vD3PbaKMJjTM5BS25nIV8FhQwQphu0juy1AMTVBJWMTbgEhQ5bC6UZ/DkjvI0t/I
Received: from ary.qy ([IPv6:2001:470:1f07:1126::78:696d:6170]) by imap.iecc.com ([IPv6:2001:470:1f07:1126::78:696d:6170]) with ESMTPS (TLS1.2 ECDHE-RSA AES-256-GCM AEAD) via TCP6; 23 Jul 2020 02:45:52 -0000
Received: by ary.qy (Postfix, from userid 501) id 38FAE1D65AD2; Wed, 22 Jul 2020 22:45:52 -0400 (EDT)
Date: Wed, 22 Jul 2020 22:45:52 -0400
Message-Id: <20200723024552.38FAE1D65AD2@ary.qy>
From: John Levine <johnl@taugh.com>
To: rfc-interest@rfc-editor.org
In-Reply-To: <71455ac8-14b1-45a7-a27f-bdeb50ed1917@www.fastmail.com>
Organization: Taughannock Networks
X-Headerized: yes
Mime-Version: 1.0
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>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>

In article <71455ac8-14b1-45a7-a27f-bdeb50ed1917@www.fastmail.com> you write:
>In rust documentation, there is a flag for example code that says "this code is invalid".  That is
>separate from the (implied) type.
>
>I don't see it being necessary to fix the "this is invalid, but it is if you add it to this other
>thing".  But that might be fixed with an excerpt flag that says "this is an excerpt (from X?) and
>therefore not valid on its own".

If people can come up with a list of conventional code types, we can encourage people to use them.

>As for IANA maintaining a registry of types, sure.  I had no idea that this was a thing until the
>tls-syntax tag was added by the editor to one of my drafts.

Once again, no.  The RSE keeps a list of conventional artwork types, not IANA.  See RFC 7991, sec 2.5.7.

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