[xml2rfc] preferred values for <sourcecode> type

Alice Russo <arusso@amsl.com> Tue, 05 November 2019 18:59 UTC

Return-Path: <arusso@amsl.com>
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 2653C1209C0 for <xml2rfc@ietfa.amsl.com>; Tue, 5 Nov 2019 10:59:21 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.199
X-Spam-Level:
X-Spam-Status: No, score=-4.199 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_NONE=0.001, 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 7baOd_tiSF2v for <xml2rfc@ietfa.amsl.com>; Tue, 5 Nov 2019 10:59:19 -0800 (PST)
Received: from mail.amsl.com (c8a.amsl.com [4.31.198.40]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id DDABE1209D6 for <xml2rfc@ietf.org>; Tue, 5 Nov 2019 10:59:18 -0800 (PST)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id 41349201C86 for <xml2rfc@ietf.org>; Tue, 5 Nov 2019 10:57:22 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
Received: from c8a.amsl.com ([127.0.0.1]) by localhost (c8a.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id T7ng4QLWUomA for <xml2rfc@ietf.org>; Tue, 5 Nov 2019 10:57:22 -0800 (PST)
Received: from [10.0.0.219] (c-71-227-153-114.hsd1.wa.comcast.net [71.227.153.114]) by c8a.amsl.com (Postfix) with ESMTPSA id 031C0201871 for <xml2rfc@ietf.org>; Tue, 5 Nov 2019 10:57:21 -0800 (PST)
From: Alice Russo <arusso@amsl.com>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\))
Message-Id: <75846CEA-B2A5-4A68-B583-35FFD6B1E3E2@amsl.com>
Date: Tue, 05 Nov 2019 10:59:17 -0800
To: xml2rfc@ietf.org
X-Mailer: Apple Mail (2.3273)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml2rfc/GKWP4da9W5IYDrv6M7dNpdbHOOc>
Subject: [xml2rfc] preferred values for <sourcecode> type
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: Tue, 05 Nov 2019 18:59:21 -0000

An FYI and a proposal regarding <sourcecode> type are below. ("The value of this attribute is free text with certain values designated as preferred." - RFC 7991)

From the FAQ:
> 7.9  What are the preferred values for the type of the <sourcecode> element?
> 
> Please see the list on [1] https://www.rfc-editor.org/materials/sourcecode-types.txt.
> For details, see Section 2.48.4 of [RFC7991].

FYI, since RFC 7991, 'sdp' and 'yangtree' were added to [1].

Proposal: add 'enumerated' to the list, as described in Section 3.5 of RFC 8446 (https://www.rfc-editor.org/rfc/rfc8446#section-3.5).

Use case: in Sections 3 and 4 of https://www.ietf.org/id/draft-bruckert-brainpool-for-tls13-07.txt. Example below.

Please let us know if this is not acceptable. Or, if something more general like 'datatype' is preferred.

Thanks,
Alice
--

example:

<sourcecode type="enumerated">
           enum {
                brainpoolP256r1tls13(31),
                brainpoolP384r1tls13(32),
                brainpoolP512r1tls13(33)
           } NamedGroup;
</sourcecode>