From nobody Sat Apr 11 10:48:10 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id CF9E0ECAAD4 for ; Mon, 29 Aug 2022 23:32:52 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229705AbiH2Xcu (ORCPT ); Mon, 29 Aug 2022 19:32:50 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45378 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229488AbiH2Xcj (ORCPT ); Mon, 29 Aug 2022 19:32:39 -0400 Received: from mail-oa1-x2e.google.com (mail-oa1-x2e.google.com [IPv6:2001:4860:4864:20::2e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CEB3282848; Mon, 29 Aug 2022 16:32:38 -0700 (PDT) Received: by mail-oa1-x2e.google.com with SMTP id 586e51a60fabf-11c5505dba2so12935167fac.13; Mon, 29 Aug 2022 16:32:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc; bh=zCCrxwttgbjoHUFJXgo6b/XsRuRpmo/BC4fXPdswmEY=; b=kz3FwI+wQpYmECto1j3t7UVr+XwvZi9hNcExNwUFXNxa5r/hFFG8/DswIEPj7xVSBU qWHiaRhMEEy8z+D1svO+bGldvLZBTRjbdJj0LfL3ty+A5jPOvT8jVKz456ZHzjWHTuGR bP1Wv/vTiqQWYfOxbuKUaHvtuCpG624OILzqCkvUDCf6kuZ/IHpYWkf0odGha8jhEy2C DKPmqH8/bKMF/54p0eEG89FDEDV9vAbqihLxosQm9+YQDNmQLSSY6+N6KlYygsigO1ZO WK5uLjfq2po8cSa30xwtujNdvGLU88SAfjT4tNAtohSQNupNKdP7Bf+R95c95/8R6qKn z7qA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc; bh=zCCrxwttgbjoHUFJXgo6b/XsRuRpmo/BC4fXPdswmEY=; b=P+7OWO/Ei4h5KpTG7Iy2Qk8I3LzebePF8lx+/mcMg5UxwDdkAlj75x/pQCCHzobnwC kPJNM8a0AV4096WP/7HA0x9E/Q/iHBqxBov2gVUwhNa4QMR9fpq0yDY/BeFFZ9+uBBLO 4oAkX3hRyZ+q23UwH/Gr6VeRM4vLgrxaBd4Jy6gTxhcZR66OUryxxt0QAf4f+eYwdsZZ 6Uh0fOMMvIqwEla1e69fnfQQjD8IH7hwWfKGLHLhuQ9lqJVuGM4XLY6Qh59RDbrun/1e eHgtgW4jgsZkG3ebh0WIfz0tjvC6nmwcznuD7pTGgypIR2vTKaO7fakgPEEcJpYqGOdx Jl3A== X-Gm-Message-State: ACgBeo12o2OD7D8sUbv7+s3oLzweXkIU7staKSDY9c6hA9bTNJ9wUcAH sTT+w7RN0nUwgA1KTvZb5iObOkS0368= X-Google-Smtp-Source: AA6agR4Xp2gdmkaqUZy4gjFgnGcMvbPg7exr/0seoU1LHcMYmt7U8xiB6w5TKWzNoQSGQ5UCZPW0cQ== X-Received: by 2002:a05:6870:240d:b0:11e:ff35:5ce8 with SMTP id n13-20020a056870240d00b0011eff355ce8mr3069268oap.232.1661815958106; Mon, 29 Aug 2022 16:32:38 -0700 (PDT) Received: from xps8900.attlocal.net ([2600:1700:2442:6db0:dd06:f7b4:b579:6561]) by smtp.gmail.com with ESMTPSA id bu28-20020a0568300d1c00b0063b24357269sm4183611otb.13.2022.08.29.16.32.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Aug 2022 16:32:37 -0700 (PDT) From: frowand.list@gmail.com To: Frank Rowand , David Gow , Shuah Khan , Kees Cook , Tim.Bird@sony.com, Brendan Higgins Cc: Jonathan Corbet , rmr167@gmail.com, guillaume.tucker@collabora.com, dlatypov@google.com, kernelci@groups.io, kunit-dev@googlegroups.com, linux-kselftest@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 1/2] ktap_v2: change version to 2-rc in KTAP specification Date: Mon, 29 Aug 2022 18:31:49 -0500 Message-Id: <20220829233150.3564612-2-frowand.list@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220829233150.3564612-1-frowand.list@gmail.com> References: <20220829233150.3564612-1-frowand.list@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" From: Frank Rowand Prepare KTAP Specification for the process of creating version 2. The version will remain "2-rc" until the final commit to complete Version 2. Adding the "-rc" ensures that none of the development versions will be mistaken for the completed version 2. After this commit, Sphinx complains that we now need more '=3D' signs: Documentation/dev-tools/ktap.rst:3: WARNING: Title overline too short. =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D The Kernel Test Anything Protocol (KTAP), version 2-rc =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D This warning will disappear in the final commit for the release of version 2, when the "-rc" is removed. Signed-off-by: Frank Rowand --- Documentation/dev-tools/ktap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index d0a9565b0f44..b9a57ceddd4f 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -1,7 +1,7 @@ .. SPDX-License-Identifier: GPL-2.0 =20 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D -The Kernel Test Anything Protocol (KTAP), version 1 +The Kernel Test Anything Protocol (KTAP), version 2-rc =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D =20 TAP, or the Test Anything Protocol is a format for specifying test results= used --=20 Frank Rowand From nobody Sat Apr 11 10:48:10 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id C71A3ECAAD2 for ; Mon, 29 Aug 2022 23:32:57 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229695AbiH2Xcz (ORCPT ); Mon, 29 Aug 2022 19:32:55 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45388 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229601AbiH2Xck (ORCPT ); Mon, 29 Aug 2022 19:32:40 -0400 Received: from mail-ot1-x32d.google.com (mail-ot1-x32d.google.com [IPv6:2607:f8b0:4864:20::32d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 225D980F57; Mon, 29 Aug 2022 16:32:40 -0700 (PDT) Received: by mail-ot1-x32d.google.com with SMTP id 6-20020a9d0106000000b0063963134d04so6990662otu.3; Mon, 29 Aug 2022 16:32:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc; bh=pcwb/p5+jybv9fHerrohgcSzr7MnKBdlSMhQ4dihg0o=; b=C7J0eUMt5+vJdczODpeq86N9bO2dDO1VQb/5YrmWv1PMUiRDIjHFGP2gaJk9xmOSG/ WsBif31jiznmqa21fK1NRx9m+oNgiG0cmEwJ9KstmIncsvQ9j11wNaZqEFUH4SR0P5vq iWFQZu5mjBB4G6K0jLMq/n/tqm3+73TUqRZHuGvtZAVnM8Ee9USrxzcg2OW+OTgoC3Zm wsKSQiKu5TNJFwPAcLxz+DtmO3ysL8kr30Ks26Le2Xw3ZgFJHm6p8/NCJsdjPFPXZ2R5 mHYl7TQ6WYVU1R/L+MKO3De7e7yo2CldLaSZ5a1ZfQ4Z94dNUK1fFNzd+rMaWUU0IraQ hqTA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc; bh=pcwb/p5+jybv9fHerrohgcSzr7MnKBdlSMhQ4dihg0o=; b=mCo2yCi+BaMo4wpx7K6VJsLZpy8Ox6CSf3uaq5qlwmMYlciKopAUXkdvNUYUqtuXD9 oDjWufNuUP2hf5lzmcMrL68n3BI3mjFRQSHorJICmHtbHPbicPrsbXBJCULGUl5P6NHc aOekpOLI9YRu7ZXpDPfN+iLruek/CKZOaBG0kqVG64OSI+Q7mEUNLtDBGQrurIOry/iD Ikr2qtmC6vayIbshdAiUuJtPMdjTqMO1e8t6JNsc4QqC5BLed8iVAzeWr1Lu4jqXl6tX /xxHGvuAtUi7N9obpwbla95Ra9k+/ngV33ThQAyf8fyfSvVyiLNnaKOSSe8h3mdab+75 v8RQ== X-Gm-Message-State: ACgBeo30W+p4zZVGjlws7WOgZ6qnxVu5wJFYm5ZEcdxitLBQZ8rnZEqj t+jmAM+olu6qbfc8m7bSs48= X-Google-Smtp-Source: AA6agR7so/qOD3k8QI/sorSQtm+h9+oaifcFsM0/9jO8R7DDJjiEXSC/Y8aivOkbLfXussd2YDsOdg== X-Received: by 2002:a9d:12d:0:b0:639:41f8:df09 with SMTP id 42-20020a9d012d000000b0063941f8df09mr7417644otu.98.1661815959492; Mon, 29 Aug 2022 16:32:39 -0700 (PDT) Received: from xps8900.attlocal.net ([2600:1700:2442:6db0:dd06:f7b4:b579:6561]) by smtp.gmail.com with ESMTPSA id bu28-20020a0568300d1c00b0063b24357269sm4183611otb.13.2022.08.29.16.32.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Aug 2022 16:32:39 -0700 (PDT) From: frowand.list@gmail.com To: Frank Rowand , David Gow , Shuah Khan , Kees Cook , Tim.Bird@sony.com, Brendan Higgins Cc: Jonathan Corbet , rmr167@gmail.com, guillaume.tucker@collabora.com, dlatypov@google.com, kernelci@groups.io, kunit-dev@googlegroups.com, linux-kselftest@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v3 2/2] ktap_v2: change "version 1" to "version 2" in examples Date: Mon, 29 Aug 2022 18:31:50 -0500 Message-Id: <20220829233150.3564612-3-frowand.list@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220829233150.3564612-1-frowand.list@gmail.com> References: <20220829233150.3564612-1-frowand.list@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" From: Frank Rowand Change the "version line" in example output from "KTAP version 1" to "KTAP version 2". Change version that should be used by compliant tests from 1 to 2. Signed-off-by: Frank Rowand --- Changes since patch version 2: - refresh version 2 patch 2/2 for new context Documentation/dev-tools/ktap.rst | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index b9a57ceddd4f..ff77f4aaa6ef 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -39,6 +39,7 @@ version of the (K)TAP standard the result is compliant wi= th. =20 For example: - "KTAP version 1" +- "KTAP version 2" - "TAP version 13" - "TAP version 14" =20 @@ -46,7 +47,7 @@ Note that, in KTAP, subtests also begin with a version li= ne, which denotes the start of the nested test results. This differs from TAP14, which uses a separate "Subtest" line. =20 -While, going forward, "KTAP version 1" should be used by compliant tests, = it +While, going forward, "KTAP version 2" should be used by compliant tests, = it is expected that most parsers and other tooling will accept the other vers= ions listed here for compatibility with existing tests and frameworks. =20 @@ -202,9 +203,9 @@ An example of a test with two nested subtests: =20 :: =20 - KTAP version 1 + KTAP version 2 1..1 - KTAP version 1 + KTAP version 2 1..2 ok 1 test_1 not ok 2 test_2 @@ -215,11 +216,11 @@ An example format with multiple levels of nested test= ing: =20 :: =20 - KTAP version 1 + KTAP version 2 1..2 - KTAP version 1 + KTAP version 2 1..2 - KTAP version 1 + KTAP version 2 1..2 not ok 1 test_1 ok 2 test_2 @@ -250,21 +251,21 @@ Example KTAP output -------------------- :: =20 - KTAP version 1 + KTAP version 2 1..1 - KTAP version 1 + KTAP version 2 1..3 - KTAP version 1 + KTAP version 2 1..1 # test_1: initializing test_1 ok 1 test_1 ok 1 example_test_1 - KTAP version 1 + KTAP version 2 1..2 ok 1 test_1 # SKIP test_1 skipped ok 2 test_2 ok 2 example_test_2 - KTAP version 1 + KTAP version 2 1..3 ok 1 test_1 # test_2: FAIL --=20 Frank Rowand