[Xml-sg-cmt] question on sourcecode type="test-vectors"

Alice Russo <arusso@amsl.com> Tue, 26 April 2022 20:56 UTC

Return-Path: <arusso@amsl.com>
X-Original-To: xml-sg-cmt@ietfa.amsl.com
Delivered-To: xml-sg-cmt@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 609DBC1FF904 for <xml-sg-cmt@ietfa.amsl.com>; Tue, 26 Apr 2022 13:56:41 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id pMGY6DoaeuMm for <xml-sg-cmt@ietfa.amsl.com>; Tue, 26 Apr 2022 13:56:37 -0700 (PDT)
Received: from c8a.amsl.com (c8a.amsl.com [4.31.198.40]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 9EC61C1FF909 for <xml-sg-cmt@ietf.org>; Tue, 26 Apr 2022 13:56:37 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by c8a.amsl.com (Postfix) with ESMTP id 83AF6425C356; Tue, 26 Apr 2022 13:56:37 -0700 (PDT)
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 QdsxdwWqCwV0; Tue, 26 Apr 2022 13:56:37 -0700 (PDT)
Received: from [192.168.4.33] (c-24-17-19-210.hsd1.wa.comcast.net [24.17.19.210]) by c8a.amsl.com (Postfix) with ESMTPSA id 4EF18425A344; Tue, 26 Apr 2022 13:56:37 -0700 (PDT)
From: Alice Russo <arusso@amsl.com>
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Mac OS X Mail 10.3 \(3273\))
Message-Id: <66806B6E-AEF2-4D4E-B3AD-66E7117EB3DC@amsl.com>
Date: Tue, 26 Apr 2022 13:56:36 -0700
Cc: RFC Editor <rfc-editor@rfc-editor.org>
To: "xml-sg-cmt@ietf.org" <xml-sg-cmt@ietf.org>
X-Mailer: Apple Mail (2.3273)
Archived-At: <https://mailarchive.ietf.org/arch/msg/xml-sg-cmt/257KE6bGVgNSV-mLZXsu8t5UcGk>
Subject: [Xml-sg-cmt] question on sourcecode type="test-vectors"
X-BeenThere: xml-sg-cmt@ietf.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: Working list for the xml and style guide change management team <xml-sg-cmt.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/xml-sg-cmt/>
List-Post: <mailto:xml-sg-cmt@ietf.org>
List-Help: <mailto:xml-sg-cmt-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/xml-sg-cmt>, <mailto:xml-sg-cmt-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Apr 2022 20:56:41 -0000

Greetings,

Re: "TCP Authentication Option (TCP-AO) Test Vectors" (see https://www.rfc-editor.org/authors/rfc9235.html#section-4.1)
sourcecode type="test-vectors" was used for most items (in sections 4.1.1 - 4.2.4, 5.1.1 - 5.2.4, etc.)

Any recommendation on best markup? Potential paths include:
a) leave as they are
b) change all to <artwork>
c) change all to <sourcecode> without type set

When asked to review the sourcecode type, the author wrote:
> As to the sourcecode mark in in each entry, there are separate components: an initial sequence number (ISN), a traffic key, the output of a packet dump, and the MAC (message authentication code). None of these are actually “sourcecode”. I don’t know what portions qualify as a “test-vector”. So I don’t know whether this marking is correct or how best to adjust it if not.


Thanks,
Alice
--

Examples of how type="test-vectors" has been used in the past (full list below):

https://www.rfc-editor.org/rfc/rfc9048.html#appendix-D 
https://www.rfc-editor.org/rfc/rfc9180.html#appendix-A.1.1 (and lots more)
https://www.rfc-editor.org/rfc/rfc9189.html#appendix-A.1.1.1 (and a few more)
(It becomes <pre class="sourcecode lang-test-vectors"> in the HTML file.)

[files in www.rfc-editor.org/in-notes/prerelease/]

rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors">
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"> 
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"> 
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8696.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8734.notprepped.xml:<sourcecode type="test-vectors"><![CDATA[
rfc8734.notprepped.xml:<sourcecode type="test-vectors"><![CDATA[
rfc8734.notprepped.xml:<sourcecode type="test-vectors"><![CDATA[
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[t(fdb97531) = 2a196f34,
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[g[87654321](fedcba98) = fdcbc20c,
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[K = ffeeddccbbaa99887766554433221100f0f1f2f3f4f5f6f7f8f9fafbfcfdfeff,]]></sourcecode>
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[K_1 = ffeeddcc,
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[(a_1, a_0) = (fedcba98, 76543210),
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[b = G^*[K_32]G[K_31]...G[K_1](a_1, a_0) = 4ee901e5c2d8ca3d.]]></sourcecode>
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[b = 4ee901e5c2d8ca3d,]]></sourcecode>
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[(b_1, b_0) = (4ee901e5, c2d8ca3d),
rfc8891.notprepped.xml:        <sourcecode type="test-vectors"><![CDATA[a = G^*[K_1]G[K_2]...G[K_32](b_1, b_0) = fedcba9876543210.]]></sourcecode>
rfc9048.notprepped.xml:      <sourcecode type="test-vectors"><![CDATA[
rfc9048.notprepped.xml:       <sourcecode type="test-vectors"><![CDATA[
rfc9048.notprepped.xml:      <sourcecode type="test-vectors"><![CDATA[
rfc9048.notprepped.xml:       <sourcecode type="test-vectors"><![CDATA[
rfc9106.notprepped.xml:<sourcecode type="test-vectors">
rfc9106.notprepped.xml:<sourcecode type="test-vectors">
rfc9106.notprepped.xml:<sourcecode type="test-vectors">
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9180.notprepped.xml:            <sourcecode name="" type="test-vectors"><![CDATA[
rfc9227.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9227.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9227.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9227.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9227.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9227.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9227.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[
rfc9227.notprepped.xml:          <sourcecode name="" type="test-vectors"><![CDATA[